Aloja tu propio n8n (self-hosted) en Square Cloud

​

Introducción

• Este artículo te guía a través de la creación y el alojamiento de una aplicación de n8n en Square Cloud.
• Antes de comenzar, asegúrate de tener una cuenta en Square Cloud, que puedes crear en la página de registro con tu correo electrónico.
• Por último, necesitas tener un plan activo con al menos 4GB de RAM en tu cuenta, como Standard: n8n se ejecuta con 3GB (MEMORY=3072 más abajo) y los planes más pequeños no tienen tanta RAM. Compara los planes disponibles y elige uno según tus necesidades.

​

Creando el proyecto

• n8n se ejecuta en Node.js, así que el proyecto solo necesita un package.json.
• El package.json lista n8n en sus dependencias y tiene un script para iniciarlo. Aquí está el ejemplo:

{
  "name": "squarecloud-n8n",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "n8n"
  },
  "author": "Square Cloud Education <squarecloud.app>",
  "license": "ISC",
  "dependencies": {
    "n8n": "2.41.3"
  }
}

• La versión de n8n está fijada a propósito: latest puede saltar a una nueva versión mayor con cambios incompatibles en cualquier reinstalación. n8n 2.x necesita Node.js 24 o superior, que VERSION=recommended proporciona.
• Para actualizar más adelante, consulta la versión más reciente con npm view n8n version, lee las notas de versión de n8n, cambia la versión en package.json y vuelve a subir tu proyecto.

​

Archivos en tu ZIP

• package.json
• squarecloud.app (el archivo de configuración de abajo)
• .env (opcional, con las variables de abajo)

​

Archivo de configuración

• Al subir desde el dashboard, define manualmente el runtime como Node.js y usa npm run start como comando de inicio. En un archivo de configuración squarecloud.app, se ve así:

DISPLAY_NAME=App name
RUNTIME=nodejs
START=npm run start
MEMORY=3072
VERSION=recommended
SUBDOMAIN=my-n8n-subdomain

• El valor de MEMORY de arriba sigue las reglas de dimensionamiento de la plataforma: consulta por qué existen los mínimos de RAM si quieres ajustarlo.
• A continuación, define las variables de entorno de abajo. Puedes ponerlas en un archivo .env en la raíz del proyecto (n8n lo carga al iniciar) o definirlas en la Configuración avanzada del formulario de subida. Reemplaza my-n8n-subdomain por tu SUBDOMAIN.

N8N_PORT=80
N8N_LISTEN_ADDRESS=0.0.0.0
N8N_HOST=my-n8n-subdomain.squareweb.app
N8N_PROTOCOL=https
N8N_WEBHOOK_URL=https://my-n8n-subdomain.squareweb.app/

• N8N_PORT y N8N_LISTEN_ADDRESS hacen que n8n escuche en el puerto 80 en todas las interfaces, donde Square Cloud entrega el tráfico de tu subdominio. n8n no lee la variable PORT que define Square Cloud, así que N8N_PORT es obligatoria.
• N8N_HOST, N8N_PROTOCOL y N8N_WEBHOOK_URL le indican a n8n su dirección pública. Sin N8N_WEBHOOK_URL, las URL de webhook que n8n muestra en tus flujos apuntan al puerto interno y los servicios externos no pueden alcanzarlas. Las guías más antiguas llaman a esta variable WEBHOOK_URL, que n8n 2.x marca como obsoleta. Consulta las variables de endpoints de n8n para ver más opciones.
• Las variables definidas en el dashboard tienen prioridad sobre el archivo .env. Consulta Variables de entorno para saber cómo gestionarlas.

​

Subiendo el proyecto a Square Cloud

​

A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Creando la cuenta de propietario

​

Consideraciones finales

​

Próximos pasos

​

Contáctanos