Saltar al contenido principal

​
Introducción

Para desarrollar y alojar una instancia de n8n en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.

​
Requisitos previos

  • Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
  • Plan activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.
n8n se ejecuta con 3 GB de RAM (MEMORY=3072 más abajo), así que necesita un plan con al menos 4 GB, como Standard: los planes más pequeños no tienen tanta RAM. Esta guía usa el runtime de Node.js.

​
Obtener el proyecto

n8n se ejecuta en Node.js, así que el proyecto solo necesita un package.json que liste n8n en sus dependencias y tenga un script para iniciarlo:
package.json
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.
Ya tenemos todo listo para el deploy en nuestras releases de n8n-web. Solo necesitas descargar el project.zip y subirlo.

​
Configurar Square Cloud

Crea un archivo squarecloud.app en la raíz de tu proyecto:
squarecloud.app
START=npm run start ejecuta el script start de tu package.json. Al subir desde el dashboard, define manualmente el runtime como Node.js y usa npm run start como comando de inicio. El valor de MEMORY sigue las reglas de dimensionamiento de la plataforma: consulta por qué existen los mínimos de RAM si quieres ajustarlo.

​
Variables de entorno

Define las variables de abajo. Puedes ponerlas en un archivo .env en la raíz del proyecto (n8n lo carga al iniciar) o definirlas como variables de entorno de la aplicación, en la Configuración avanzada del formulario de subida o en el dashboard. Reemplaza my-n8n-subdomain por tu SUBDOMAIN.
.env
  • 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. Las guías más antiguas llaman a la última 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.

​
Qué va en el ZIP

  • package.json
  • squarecloud.app
  • .env, si guardas en él las variables de arriba
Deja fuera node_modules/: Square Cloud instala n8n en el servidor.

​
Hacer deploy y verificar

​
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.
Subiendo aplicación a Square Cloud
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

Para usar este método, tu proyecto necesita un archivo de configuración llamado squarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.

Guía del archivo de configuración

Aprende a crear el archivo de configuración squarecloud.app que define el entorno de tu aplicación.
1

Instala la CLI

Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:
2

Inicia sesión

Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.
3

Sube tu proyecto

Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista squarecloud.ignore, y lo sube:
Para subir un zip que creaste tú mismo, pásalo con --file:
4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:
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.

​
Primer acceso

Justo después del deploy, abre https://my-n8n-subdomain.squareweb.app y crea la cuenta de propietario. Quien abra la página primero se convierte en el propietario de la instancia, así que hazlo antes de compartir la URL con nadie.

​
Errores comunes

​
Dominio personalizado

Para usar un dominio personalizado (por ejemplo, mysite.com) en lugar de la URL predeterminada mysite.squareweb.app, necesitas el plan Standard o superior. La URL predeterminada sale del campo SUBDOMAIN del archivo de configuración. Para conectar tu dominio, sigue cómo configurar tu propio dominio.

​
Requisitos mínimos de RAM

Mínimo: 512MB de RAM para sitios web y APIs, suficiente para un build estático en el runtime estático. Para apps que renderizan páginas en un servidor (Next.js, Nuxt, Angular SSR y similares), recomendamos al menos 1GB de RAM. Para aplicaciones más grandes, asigna más RAM para evitar que la aplicación se quede sin memoria y falle.

​
No se pudo encontrar este sitio.

Verifica que el subdominio/dominio coincida con lo configurado en el campo SUBDOMAIN o en la configuración del dominio personalizado. Si acabas de subir el sitio, espera hasta 60 segundos para que Square habilite el primer acceso.

​
El sitio tardó demasiado en responder…

Tu servidor debe escuchar en el puerto 80 y el host 0.0.0.0. Square Cloud define las variables de entorno PORT (80) y HOST (0.0.0.0) en tu aplicación: léelas en tu código en lugar de fijar otros valores. Un servidor que escucha solo en localhost o 127.0.0.1 nunca recibe solicitudes.

​
n8n no responde en tu subdominio

n8n ignora las variables PORT y HOST. Comprueba que N8N_PORT=80 y N8N_LISTEN_ADDRESS=0.0.0.0 estén definidas y luego reinicia la aplicación.

​
Las URL de webhook apuntan al puerto interno

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. Define N8N_WEBHOOK_URL con tu dirección pública, por ejemplo https://my-n8n-subdomain.squareweb.app/, y luego reinicia la aplicación.

​
Próximos pasos

Variables de entorno

Gestiona los ajustes y secretos de n8n desde el dashboard o la CLI.

Dominio personalizado

Sirve n8n desde tu propio dominio y luego actualiza N8N_HOST y N8N_WEBHOOK_URL.

Uptime Kuma

Monitorea n8n y tus demás servicios.
Para más información sobre n8n, consulta la documentación oficial de n8n.

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.