¿Cómo instalar n8n con Docker Compose en un servidor cloud?

Receta paso a paso para instalar n8n con Docker Compose en un servidor cloud Linux: subdominio, Caddy con HTTPS, volumen persistente, clave de cifrado, cortafuegos, respaldos y cuándo conviene Dongee Cloud o el plan de n8n.

Para instalar n8n con Docker Compose en un servidor cloud necesitas un servidor Linux con acceso root por SSH, Docker y Docker Compose instalados y un subdominio que apunte a la IP del servidor. Después creas un docker-compose.yml con dos servicios: Caddy como proxy inverso con HTTPS automático y n8n con un volumen persistente. Lo levantas con docker compose up -d y creas el usuario propietario desde el navegador.

Esta receta sirve para cualquier servidor cloud Linux con acceso root. Usamos Dongee Cloud como ejemplo. Los valores de dominio, zona horaria y clave son ficticios: cámbialos por los tuyos. Las variables y los comandos pueden cambiar entre versiones de n8n, así que revisa la documentación oficial de n8n para la versión que instales.

1. Elige el servidor

Los recursos que necesita n8n dependen de cuántos flujos tengas activos, de cada cuánto se ejecutan y de cuántos datos mueve cada ejecución. Unos pocos flujos programados no consumen lo mismo que cientos de webhooks por minuto. Lo práctico es empezar con un servidor modesto y vigilar el consumo. En Dongee Cloud puedes escalar CPU, RAM y disco sin reiniciar ni migrar si el servidor se queda corto. Si prefieres armar el servidor a tu medida, mira Cloud On Demand y la guía para calcular el precio de un servidor cloud a medida.

2. Conéctate por SSH como root

Usa la IP de tu servidor y tu acceso root (la IP del ejemplo es ficticia):

ssh root@203.0.113.10

3. Instala Docker y Docker Compose

Si tu servidor usa Ubuntu, sigue la guía para instalar Docker en Ubuntu. Al terminar, confirma que todo funciona:

docker --version
docker compose version

Si es la primera vez que usas archivos de Compose, lee primero qué es Docker Compose.

4. Apunta un subdominio a la IP del servidor

En el panel donde administras el DNS de tu dominio, crea un registro A con el nombre n8n (para que quede n8n.tudominio.com) y como valor la IP del servidor. Espera a que el cambio se propague antes de seguir. Caddy necesita que el subdominio ya resuelva a tu servidor para obtener el certificado HTTPS.

ping n8n.tudominio.com

5. Crea la carpeta y los archivos

mkdir -p /opt/n8n && cd /opt/n8n

Archivo .env

Genera una clave de cifrado aleatoria con openssl rand -hex 32 y pégala en el archivo. El ejemplo de abajo usa valores ficticios:

N8N_HOST=n8n.tudominio.com
GENERIC_TIMEZONE=America/Bogota
N8N_ENCRYPTION_KEY=pega-aqui-la-clave-generada-con-openssl

Protege el archivo con chmod 600 .env.

Caddyfile

n8n.tudominio.com {
    reverse_proxy n8n:5678
}

docker-compose.yml

services:
  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    depends_on:
      - n8n

  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    environment:
      - N8N_HOST=${N8N_HOST}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://${N8N_HOST}/
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:
  caddy_data:
  caddy_config:

Fíjate en que el servicio n8n no tiene ports. Solo Caddy lo alcanza, por la red interna de Compose. Así el puerto 5678 nunca queda expuesto a internet.

6. Levanta n8n y crea el usuario propietario

docker compose up -d
docker compose logs -f

Cuando los registros muestren que n8n está listo, abre https://n8n.tudominio.com en el navegador. La primera vez, n8n te pide crear la cuenta de propietario. Hazlo enseguida para que nadie más la reclame.

7. Actualiza y respalda

Para actualizar a la imagen más reciente:

cd /opt/n8n
docker compose pull
docker compose up -d

Antes de actualizar, lee las notas de versión de n8n, porque algunas versiones traen cambios incompatibles. Para respaldar el volumen de datos (busca su nombre exacto con docker volume ls; normalmente lleva el nombre de la carpeta como prefijo):

docker compose stop n8n
docker run --rm -v n8n_n8n_data:/data -v /opt/n8n:/backup alpine \
  tar czf /backup/n8n-backup-$(date +%F).tar.gz -C /data .
docker compose start n8n

Guarda esa copia fuera del servidor, junto con una copia del archivo .env.

Seguridad básica

  • No expongas el puerto 5678. Todo el tráfico debe pasar por el proxy con HTTPS.
  • Usa siempre HTTPS. Por n8n pasan credenciales de APIs, bases de datos y cuentas de terceros.
  • Guarda la N8N_ENCRYPTION_KEY en un lugar seguro. Sin ella no puedes recuperar las credenciales guardadas en n8n, aunque tengas el respaldo del volumen.
  • Configura un cortafuegos que solo abra los puertos 22, 80 y 443:
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable

Por qué Dongee Cloud funciona para esta receta

  • Acceso root por SSH y Docker y Docker Compose sin restricciones.
  • Procesadores Intel Xeon sin GPU. n8n no la necesita.
  • Discos NVMe, IP dedicada y despliegue en menos de 3 minutos.
  • Backup de disco incluido en todos los planes Cloud. Dongee Backup es un producto aparte y de pago.
  • 11 ubicaciones: Atlanta, Miami, Nueva York, Dallas, México, São Paulo, Santiago, Frankfurt, Madrid, Londres y Ámsterdam.
  • Es autogestionado: tú administras el servidor. Tienes soporte 24/7 y asistencia para migrar.

Precios mensuales: Cloud 1, 17 USD; Cloud 2, 34 USD; Cloud 3, 68 USD; Cloud 4, 136 USD; Cloud 5, 272 USD; Cloud 6, 544 USD; Cloud 7, 1.088 USD. Con Cloud On Demand pagas 6 USD por vCPU, 3 USD por GB de RAM y 0,3 USD por GB de disco, con un mínimo de 17 USD al mes.

Comparación honesta: autoalojar en Cloud o usar el plan de n8n

Criterion8n autoalojado en Dongee CloudPlan de n8n de Dongee
PrecioCloud 1 a Cloud 7 (17 a 1.088 USD/mes) o Cloud On Demand con un mínimo de 17 USDDesde 6 USD
Administración del servidorLa haces tú: actualizaciones, cortafuegos, respaldosRevisa en la página del plan de n8n qué incluye
ControlTotal: root, otros contenedores, Postgres, más servicios en el mismo servidorConsulta las condiciones en su página
Para quiénQuien sabe administrar Linux y DockerQuien prefiere una opción lista para n8n; revisa en su página qué incluye

Cuándo no te conviene esta receta en Dongee Cloud: si no quieres encargarte de parches, respaldos y seguridad, revisa antes el plan de n8n de Dongee (desde 6 USD) y lo que incluye. Si quieres correr modelos de IA locales junto a n8n y necesitas GPU, Dongee Cloud no la ofrece.

Preguntas frecuentes

¿Puedo usar PostgreSQL en vez de SQLite?

Sí. Agrega un servicio de Postgres al docker-compose.yml y configura en n8n las variables de conexión a la base de datos. Revisa la documentación oficial de n8n para ver las variables exactas de tu versión.

¿n8n necesita GPU?

No. n8n orquesta flujos y llama a APIs, y funciona bien con CPU. Por eso un servidor Intel Xeon sin GPU le basta.

¿Cómo actualizo n8n?

Entra a la carpeta del proyecto y ejecuta docker compose pull y luego docker compose up -d. Haz un respaldo del volumen antes y lee las notas de versión.

¿Qué pasa si pierdo la N8N_ENCRYPTION_KEY?

Tus flujos siguen en el volumen, pero no podrás descifrar las credenciales guardadas y tendrás que volver a ingresarlas. Guárdala fuera del servidor.

¿Qué hago si el servidor se queda corto?

En Dongee Cloud puedes escalar CPU, RAM y disco sin reiniciar ni migrar.

En resumen

Con un servidor con root, Docker Compose, Caddy y un volumen persistente tienes n8n en tu propio dominio con HTTPS en pocos pasos. Lo que más importa es lo que viene después: guardar la clave de cifrado, respaldar el volumen y mantener el servidor actualizado. Si eso no es para ti, revisa el plan de n8n de Dongee.

Comenta lo que quieras

Unete a la charla
Solo ingresa tu email