Automatización de despliegue: configurar n8n con Coolify — guía paso a paso

Guía paso a paso para configurar n8n en Coolify: desde la instalación hasta despliegues automáticos e integración con GitHub.

Cómo ejecutar n8n en Coolify: guía completa

n8n es una potente herramienta de automatización y Coolify es una plataforma para self-hosting. Juntos forman un sistema autónomo de automatización sin dependencias de la nube. En esta guía — configuración paso a paso.

Requisitos previos

  • VPS con Ubuntu 22.04 o 24.04 (se recomienda mínimo 2 GB de RAM)
  • Dominio que apunte al servidor
  • Conocimientos básicos de SSH y línea de comandos

Paso 1: Instalación de Coolify

Conéctate al servidor y ejecuta la instalación:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

El script instalará Docker, Docker Compose y el propio Coolify. Al terminar, en la consola aparecerá la URL y la contraseña para el primer inicio de sesión.

Abre Coolify en el navegador, establece una nueva contraseña y accede al panel de control.

Paso 2: Preparación del proyecto

En Coolify crea un nuevo proyecto. Nómbralo, por ejemplo, «Automation». Dentro del proyecto crea un entorno «Production».

Paso 3: Instalación de n8n

En el entorno haz clic en «Add Resource» → «Service» → selecciona «n8n» de la lista de servicios listos.

Coolify propondrá la configuración estándar de n8n. Parámetros importantes:

  • PostgreSQL — recomendamos usar una BD externa o el servicio integrado de Coolify para producción. SQLite sirve para pruebas.
  • Dominio — indica el subdominio (n8n.tudominio.com), Coolify configurará SSL automáticamente.
  • Variables de entorno — configura N8N_ENCRYPTION_KEY (¡obligatorio para producción!).
N8N_ENCRYPTION_KEY=tu-cadena-aleatoria-aqui
WEBHOOK_URL=https://n8n.tudominio.com

Haz clic en «Deploy». En un par de minutos n8n estará disponible en el dominio indicado.

Paso 4: Despliegue automático mediante GitHub

Para que las actualizaciones de los flujos se almacenen en Git y se desplieguen automáticamente:

  1. Conecta la integración de GitHub en Coolify (Settings → Git Providers)
  2. Crea un repositorio para los flujos de n8n
  3. Configura en Coolify el despliegue Git para el servicio n8n
  4. Indica la rama y el directorio

Ahora, al hacer push a la rama main, Coolify reiniciará automáticamente n8n con los nuevos datos.

Paso 5: Monitorización

Coolify muestra el uso de CPU/memoria/disco para cada servicio. Configura alertas al superar los umbrales — n8n puede consumir mucha memoria en flujos pesados.

Variables de entorno útiles para n8n

# Base de datos
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=contraseña-segura

# Logging
N8N_LOG_LEVEL=info
N8N_LOG_OUTPUT=console

# Timeouts
EXECUTIONS_TIMEOUT=3600
N8N_METRICS=true

Conclusión

n8n + Coolify es una combinación potente para crear infraestructura de automatización autónoma. Sin suscripciones a la nube, con control total sobre los datos. La configuración toma 20-30 minutos y se amortiza con la ausencia de facturas mensuales.

Sitio oficial de n8n | Sitio oficial de Coolify