Cómo autoalojar n8n en 2026 (Docker, Traefik y Dokploy)

Zapier cobra por tarea. Make cobra por operación. Si ejecutas más que un puñado de automatizaciones, la factura sube rápido. Autoalojar n8n te da ejecuciones ilimitadas en tu propio hardware por lo que cuesta un VPS.

n8n es una plataforma de automatización de flujos de trabajo de código abierto (fair-code, Sustainable Use License) en su versión estable 2.37.x, con más de 203 000 estrellas en GitHub y más de 100 millones de pulls en Docker. Puedes autoalojar n8n en un VPS barato con Docker Compose y obtener el mismo constructor visual de flujos de trabajo, más de 1 000 integraciones y disparadores webhook por los que cobran los servicios en la nube. n8n 3.0 está previsto para octubre de 2026 y convertirá Docker en el único método de autoalojamiento soportado. Si todavía ejecutas npx n8n, ahora es el momento de migrar.

Esta guía cubre cuatro opciones de instalación listas para producción: Docker Compose independiente, proxy inverso Traefik, despliegue con la interfaz gráfica de Dokploy y modo de cola con PostgreSQL para escalar.

¿Qué es n8n?

n8n (pronunciado «nodemation») es una plataforma visual de automatización de flujos de trabajo que conecta servicios y automatiza tareas mediante un editor basado en nodos. Piensa en ella como una alternativa autoalojada a Zapier o Make. Arrastras nodos a un lienzo, los conectas y los datos fluyen de uno al siguiente. La diferencia es que tú controlas la infraestructura y los datos nunca salen de tus servidores.

Ventajas clave de n8n

Un par de funciones que conviene destacar: la integración con control de versiones Git y el soporte multi-entorno (desarrollo/staging/producción) requieren una licencia de pago. La edición Community cubre todo lo que necesita quien trabaja en solitario: flujos de trabajo, pasos, ejecuciones y usuarios ilimitados.

Puedes explorar el código en el repositorio oficial de GitHub o visitar n8n.io para consultar la documentación.

Cómo funciona n8n

n8n usa nodos. Cada nodo representa una función o una integración de servicio. Creas flujos de trabajo conectando nodos en secuencia, y los datos fluyen de un nodo al siguiente.

Este enfoque modular te permite construir desde simples tareas de sincronización de datos hasta complejos procesos de negocio de varios pasos.

n8n 2.0 y 3.0: qué cambió para quienes se autoalojan

n8n 2.0 se lanzó en diciembre de 2025 e introdujo varios cambios disruptivos que afectan a los despliegues autoalojados:

• Seguro por defecto: los nodos Code ya no pueden acceder a las variables de entorno (N8N_BLOCK_ENV_ACCESS_IN_NODE=true). Los nodos de archivos están restringidos a ~/.n8n-files.
• Modelo Publicar/Guardar: los flujos de trabajo ahora tienen un estado de borrador frente a publicado, que sustituye al antiguo interruptor activo/inactivo.
• PostgreSQL recomendado: el soporte de MySQL/MariaDB se eliminó por completo. PostgreSQL 17/18 es la base de datos recomendada para producción.
• Task runners activados por defecto: la ejecución de los nodos Code está aislada en procesos runner separados.
• Informe de migración: una herramienta integrada (Settings → Migration Report) que marca los flujos de trabajo afectados por cambios disruptivos antes de actualizar.

Tareas antes de actualizar:

1. Ejecuta el informe de migración (Settings → Migration Report) para identificar los flujos de trabajo afectados
2. Lee los cambios disruptivos de la v2.0 y los cambios disruptivos de la v3.0
3. Fija la etiqueta de tu imagen Docker. No dependas de latest en producción

Requisitos del sistema y prerrequisitos de n8n

n8n es ligero, pero la RAM es el cuello de botella. El proceso de Node.js es de un solo hilo, y los flujos de trabajo complejos con grandes cargas JSON consumen memoria, no CPU. El modo de cola añade aproximadamente 1 GB para los workers.

Especificaciones recomendadas:

Opción de instalación 1: instalar n8n con Docker Compose (independiente)

Es la instalación más sencilla. Un solo contenedor n8n con SQLite. Buena para empezar, para desarrollo o para uso en solitario con un volumen moderado de flujos de trabajo.

Paso 1: crear el directorio del proyecto

mkdir -p ~/n8n-automation && cd ~/n8n-automation

Paso 2: crear la configuración de Docker Compose

services:
  n8n:
    image: docker.io/n8nio/n8n:2.37.7
    container_name: n8n-app
    restart: unless-stopped
    ports:
      - '5678:5678'
    environment:
      - N8N_EDITOR_BASE_URL=http://localhost:5678
      - N8N_WEBHOOK_URL=http://localhost:5678
      - GENERIC_TIMEZONE=UTC
      - TZ=UTC
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_DEFAULT_BINARY_DATA_MODE=filesystem
      - N8N_LOG_LEVEL=info
      - N8N_LOG_OUTPUT=console
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=336
    volumes:
      - ./data:/home/node/.n8n
      - ./files:/files
    cap_drop:
      - ALL
    cap_add:
      - SETUID
      - SETGID
      - CHOWN
      - DAC_OVERRIDE
    healthcheck:
      test: ['CMD', 'wget', '--no-verbose', '--tries=1', '--spider', 'http://localhost:5678/healthz']
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Cambios clave respecto al compose antiguo: se eliminó version: '3.8' (obsoleto en Compose v2), se eliminó VUE_APP_URL_BASE_API (sin efecto en Docker), se reemplazó WEBHOOK_URL por N8N_WEBHOOK_URL, se quitó Redis y se fijó la etiqueta de la imagen.

Paso 3: inicializar la configuración

# Create required directories
mkdir -p {data,files}

# Generate a secure encryption key
echo "N8N_ENCRYPTION_KEY=$(openssl rand -base64 32)" > .env

# Set proper permissions
chmod 700 data
chmod 755 files

Paso 4: lanzar y verificar

# Launch the container
docker compose up -d

# Verify it's running
docker compose ps

# Check logs for issues (look for deprecation warnings)
docker compose logs -f n8n

Verifica el endpoint de salud:

curl -s http://localhost:5678/healthz

Deberías obtener una respuesta 200 OK. Si los logs muestran una advertencia de deprecación de WEBHOOK_URL, usaste el nombre antiguo de la variable. Actualízalo a N8N_WEBHOOK_URL.

Paso 5: acceder a n8n

Ve a http://localhost:5678 en tu navegador. Crea tu cuenta de administrador y empieza a construir flujos de trabajo.

Opción de instalación 2: n8n detrás de un proxy inverso Traefik

Esta es la instalación de producción de instancia única: HTTPS automático vía Let’s Encrypt, enrutado por dominio y gestión opcional con Dockge.

Paso 1: preparar la red de Traefik

# Create the Traefik network if it doesn't exist
docker network create traefik-net 2>/dev/null || echo "Network already exists"

# Verify
docker network ls | grep traefik-net

Paso 2: Docker Compose con etiquetas de Traefik

services:
  n8n:
    image: docker.io/n8nio/n8n:2.37.7
    container_name: n8n-production
    restart: unless-stopped
    environment:
      - N8N_EDITOR_BASE_URL=https://n8n.yourdomain.com
      - N8N_WEBHOOK_URL=https://n8n.yourdomain.com
      - N8N_PROXY_HOPS=1
      - GENERIC_TIMEZONE=UTC
      - TZ=UTC
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_DEFAULT_BINARY_DATA_MODE=filesystem
      - N8N_LOG_LEVEL=warn
      - N8N_LOG_OUTPUT=file
      - N8N_METRICS=true
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=336
    volumes:
      - ./data:/home/node/.n8n
      - ./files:/files
    networks:
      - traefik-net
    cap_drop:
      - ALL
    cap_add:
      - SETUID
      - SETGID
      - CHOWN
      - DAC_OVERRIDE
    healthcheck:
      test: ['CMD', 'wget', '--no-verbose', '--tries=1', '--spider', 'http://localhost:5678/healthz']
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.n8n.rule=Host(`n8n.yourdomain.com`)"
      - "traefik.http.routers.n8n.entrypoints=https"
      - "traefik.http.routers.n8n.tls=true"
      - "traefik.http.routers.n8n.tls.certresolver=letsencrypt"
      - "traefik.http.services.n8n.loadbalancer.server.port=5678"
      - "traefik.http.routers.n8n.middlewares=security-headers@file"

networks:
  traefik-net:
    external: true

Cambios respecto a la versión anterior: se eliminó Redis (no hace falta sin modo de cola), se eliminó VUE_APP_URL_BASE_API, se reemplazó WEBHOOK_URL por N8N_WEBHOOK_URL, se añadió N8N_PROXY_HOPS=1 para Cloudflare, se quitó la clave version: y se fijó la etiqueta de la imagen.

Paso 3: desplegar con Dockge

Si usas Dockge para gestionar contenedores:

1. Accede a Dockge: abre tu instalación de Dockge
2. Crea un nuevo stack: haz clic en “Create Stack” y llámalo “n8n-production”
3. Pega la configuración: copia el contenido del Docker Compose de arriba
4. Configura el entorno: añade tu clave de cifrado y el dominio en el archivo .env
5. Despliega el stack: haz clic en deploy y vigila los logs

Paso 4: configurar el DNS y verificar

Actualiza tus registros DNS:

Una vez propagado el DNS, verifica:

curl -I https://n8n.yourdomain.com/healthz

Debería devolver 200 OK. Comprueba el panel de Traefik para confirmar que la ruta está activa.

Opción de instalación 3: desplegar n8n con Dokploy

Dokploy ofrece el despliegue más sencillo, con una interfaz gráfica que gestiona el proxy inverso, el SSL y la configuración del entorno. Ahora incluye tanto una plantilla “n8n” como una plantilla “n8n Queue Mode” (con PostgreSQL).

Paso 1: instalar Dokploy

Sigue la guía de instalación de Dokploy para configurar la plataforma en tu servidor.

Paso 2: crear la aplicación n8n

1. Accede al panel de Dokploy: inicia sesión en tu instancia de Dokploy
2. Crea un nuevo proyecto: haz clic en “New Project” y llámalo “n8n-automation”
3. Selecciona la plantilla: elige “n8n” entre las plantillas disponibles (o “n8n Queue Mode” para producción con PostgreSQL)
4. Configura los ajustes básicos: define el nombre y la descripción de tu aplicación

Paso 3: configurar las variables de entorno

Define las variables de entorno esenciales:

Paso 4: dominio y despliegue

1. Añade el dominio: en Dokploy, ve a los ajustes de tu aplicación n8n
2. Configura el SSL: activa la generación automática de certificados SSL
3. Define el dominio: introduce tu subdominio (p. ej., n8n.yourdomain.com)
4. Despliega: haz clic en el botón de despliegue y sigue el proceso

Una vez desplegado, accede a tu instancia de n8n con el dominio configurado y crea tu cuenta de administrador.

Opción de instalación 4: modo de cola de n8n con PostgreSQL

El modo de cola es para escalar. Si ejecutas más de ~50 ejecuciones concurrentes, necesitas escalado horizontal o quieres la robustez de PostgreSQL, esta es tu configuración.

Visión general de la arquitectura

En modo de cola, la instancia principal de n8n gestiona el editor, los webhooks y los triggers. Los workers procesan las ejecuciones desde una cola respaldada por Redis. Los runners se encargan del aislamiento de los nodos Code. PostgreSQL almacena todos los datos.

Internet → Traefik → n8n (main) ↔ PostgreSQL
                         ↓
                       Redis (queue)
                         ↓
                    n8n-worker ↔ n8n-runner

Docker Compose para el modo de cola

services:
  postgres:
    image: postgres:18
    restart: always
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - pg-data:/var/lib/postgresql/data
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}']
      interval: 5s
      timeout: 5s
      retries: 10

  redis:
    image: redis:7-alpine
    restart: always
    command: redis-server --appendonly yes --maxmemory 512mb --maxmemory-policy allkeys-lru
    volumes:
      - redis-data:/data
    healthcheck:
      test: ['CMD', 'redis-cli', 'ping']
      interval: 15s
      timeout: 5s
      retries: 3

  n8n:
    image: docker.io/n8nio/n8n:2.37.7
    restart: always
    ports:
      - '5678:5678'
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
      - N8N_EDITOR_BASE_URL=https://n8n.yourdomain.com
      - N8N_WEBHOOK_URL=https://n8n.yourdomain.com
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - N8N_DEFAULT_BINARY_DATA_MODE=database
      - N8N_METRICS=true
      - GENERIC_TIMEZONE=UTC
      - TZ=UTC
    volumes:
      - n8n-data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    healthcheck:
      test: ['CMD', 'wget', '--no-verbose', '--tries=1', '--spider', 'http://localhost:5678/healthz']
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  n8n-worker:
    image: docker.io/n8nio/n8n:2.37.7
    restart: always
    command: worker
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - N8N_DEFAULT_BINARY_DATA_MODE=database
      - N8N_RUNNERS_MODE=external
      - N8N_RUNNERS_AUTH_TOKEN=${RUNNERS_AUTH_TOKEN}
      - N8N_RUNNERS_BROKER_LISTEN_ADDRESS=0.0.0.0
      - GENERIC_TIMEZONE=UTC
      - TZ=UTC
    volumes:
      - n8n-data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy

  n8n-runner:
    image: docker.io/n8nio/runners:2.37.7
    restart: always
    environment:
      - N8N_RUNNERS_AUTH_TOKEN=${RUNNERS_AUTH_TOKEN}
      - N8N_RUNNERS_TASK_BROKER_URI=http://n8n:5679

volumes:
  pg-data:
  redis-data:
  n8n-data:

Crea el archivo .env:

cat > .env << 'EOF'
POSTGRES_USER=n8n
POSTGRES_PASSWORD=change_me_to_a_strong_password
POSTGRES_DB=n8n
N8N_ENCRYPTION_KEY=$(openssl rand -base64 32)
RUNNERS_AUTH_TOKEN=$(openssl rand -base64 32)
EOF

Lanzar y verificar el modo de cola

docker compose up -d

# Verify all 5 containers are running
docker compose ps

# Check the health endpoint
curl -s http://localhost:5678/healthz

# Check worker logs for queue connection
docker compose logs n8n-worker

Los cinco contenedores deberían aparecer como healthy. Los logs del worker deberían mostrar que se conectó a Redis y está listo para procesar trabajos. Nota: la pestaña de monitorización de workers en la interfaz de n8n es solo para Enterprise, pero los workers procesan ejecuciones sin problema en Community.

Monitorización, copias de seguridad y mantenimiento

Una vez que n8n está en marcha, hay que mantenerlo sano. Esta sección cubre comprobaciones de salud, métricas, copias de seguridad y un calendario de mantenimiento.

Monitorización de la salud

n8n expone un endpoint /healthz por defecto (configurable vía N8N_ENDPOINT_HEALTH). Para una monitorización más profunda:

Endpoint de métricas: define N8N_METRICS=true para exponer /metrics en formato Prometheus. Recógelo con Prometheus y construye dashboards en Grafana.

Trazas con OpenTelemetry: disponible desde n8n 2.19 para trazar la ejecución de flujos de trabajo. Configurable desde la interfaz a partir de la 2.27. Las etiquetas de span personalizadas son una función Enterprise (2.22+).

Logs estructurados: define N8N_LOG_OUTPUT=json para logs procesables por máquinas que funcionan con herramientas de agregación de logs.

Limpieza de ejecuciones: EXECUTIONS_DATA_PRUNE=true con EXECUTIONS_DATA_MAX_AGE=336 (14 días) es un buen valor por defecto. Añade EXECUTIONS_DATA_PRUNE_MAX_COUNT=10000 para limitar el número total de ejecuciones almacenadas.

Métricas clave a vigilar:

Estrategias de copia de seguridad

Dos caminos según tu base de datos:

SQLite (opciones 1–3):

#!/bin/bash
# n8n SQLite Backup Script
BACKUP_DIR="/backups/n8n"
DATE=$(date +%Y%m%d_%H%M%S)

mkdir -p "$BACKUP_DIR"

# Stop n8n briefly for a consistent snapshot
docker compose stop n8n

# Back up data dir (includes SQLite DB + WAL + encryption key)
tar -czf "$BACKUP_DIR/n8n_data_$DATE.tar.gz" ./data

# Back up config
cp docker-compose.yml "$BACKUP_DIR/docker-compose_$DATE.yml"
cp .env "$BACKUP_DIR/env_$DATE.backup"

# Restart
docker compose start n8n

# Clean old backups (keep last 30 days)
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete

echo "Backup completed: n8n_data_$DATE.tar.gz"

PostgreSQL (opción 4):

#!/bin/bash
# n8n PostgreSQL Backup Script
BACKUP_DIR="/backups/n8n"
DATE=$(date +%Y%m%d_%H%M%S)

mkdir -p "$BACKUP_DIR"

# Dump the database
docker compose exec -T postgres pg_dump -U ${POSTGRES_USER} ${POSTGRES_DB} | gzip > "$BACKUP_DIR/n8n_pg_$DATE.sql.gz"

# Back up .n8n volume (encryption key, logs)
tar -czf "$BACKUP_DIR/n8n_home_$DATE.tar.gz" ./n8n-data

# Back up config
cp docker-compose.yml "$BACKUP_DIR/docker-compose_$DATE.yml"
cp .env "$BACKUP_DIR/env_$DATE.backup"

# Clean old backups
find "$BACKUP_DIR" -name "*.gz" -mtime +30 -delete

echo "Backup completed: n8n_pg_$DATE.sql.gz"

Paquetes de flujos de trabajo: n8n 2.27 introdujo los paquetes .n8np (vista previa): paquetes portátiles de flujos de trabajo que puedes exportar e importar entre instancias. Útiles para migrar flujos individuales sin restaurar toda la base de datos.

Tareas de mantenimiento periódicas

Semanal:

• Revisa los logs de ejecución en busca de errores
• Comprueba el uso de disco del volumen de datos
• Verifica la integridad de las copias de seguridad

Mensual:

• Actualiza n8n a la última versión estable fijada (docker compose pull && docker compose up -d)
• Revisa los ajustes de limpieza de ejecuciones
• Audita el acceso de usuarios y las credenciales

Trimestral:

• Prueba una restauración completa desde la copia de seguridad
• Revisa el uso de recursos y escala si hace falta
• Comprueba los cambios disruptivos en el changelog de n8n antes de actualizar

Precios de n8n: Community frente a Cloud

La edición Community es gratuita y está genuinamente completa para uso en solitario: flujos de trabajo, pasos, ejecuciones y usuarios ilimitados. El modo de cola funciona en Community; solo la pestaña de monitorización de workers requiere una licencia Enterprise.

Precios de n8n Cloud (2026):

Sin límites de flujos activos en ningún plan: el precio se basa en las ejecuciones.

Las cuentas de quien opera en solitario: la edición Community + un VPS de Hetzner Cloud a 4–8 €/mes supera con creces a Cloud Starter. La licencia de pago compra SSO, paneles de Insights, entornos basados en Git, gestión de secretos externos y alta disponibilidad multi-main. Para la mayoría de operadores en solitario, Community es suficiente.

Solución de problemas comunes de n8n

Estos son los fallos que más veo con n8n autoalojado. Cada uno le ha quemado a alguien.

docker run --rm --entrypoint sh n8nio/n8n:2.37.7 -c "which wget"

healthcheck:
  test: ['CMD', 'node', '-e', "fetch('http://localhost:5678/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
  interval: 30s
  timeout: 10s
  retries: 3
  start_period: 40s

Conclusión

Autoalojar n8n te da automatización de flujos de trabajo ilimitada por lo que cuesta un VPS. Las cuatro opciones de esta guía cubren distintas necesidades:

1. Docker Compose independiente: la forma más rápida de empezar, SQLite, un solo contenedor
2. Proxy inverso Traefik: instancia única de producción con HTTPS automático y enrutado por dominio
3. Dokploy: despliegue con interfaz gráfica, proxy inverso integrado y gestión de SSL
4. Modo de cola con PostgreSQL: escalado horizontal con workers, cola Redis y runners externos

La edición Community es gratuita y cubre todo lo que necesita quien opera en solitario. Un VPS de Hetzner Cloud a 4–8 €/mes es toda la infraestructura que la mayoría necesita. Con n8n 3.0 convirtiendo Docker en el único método de autoalojamiento soportado a partir de octubre de 2026, ahora es un buen momento para dejar lista tu configuración de Docker Compose.

Próximos pasos:

1. Elige una opción de instalación y pon n8n en marcha esta misma noche
2. Construye un flujo de trabajo sencillo: un trigger webhook con una respuesta HTTP es un buen comienzo
3. Explora el directorio de integraciones para tus servicios más usados
4. Configura las copias de seguridad antes de tener algo que merezca la pena perder
5. Escala al modo de cola cuando un solo contenedor se te quede pequeño

Para más guías de autoalojamiento, consulta nuestras guías de paneles autoalojados y las recomendaciones de contenedores Docker. Si te interesa la búsqueda con IA para tus flujos del Asistente de IA de n8n, mira nuestra guía sobre búsqueda autoalojada con SearXNG.