--- title: "Cómo autoalojar n8n en 2026 (Docker, Traefik y Dokploy)" description: "Aprende a autoalojar n8n en 2026: Docker Compose listo para producción, configuraciones con Traefik y Dokploy, modo de cola con PostgreSQL, monitorización, copias de seguridad y consejos para actualizar a n8n 2.x." date: 2025-08-02 categories: ["self-hosting"] tags: ["n8n","workflow-automation","dokploy"] --- import Button from "@components/widgets/Button.astro"; import Notice from "@components/widgets/Notice.astro"; import ListCheck from "@components/widgets/ListCheck.astro"; import Accordion from "@components/widgets/Accordion.astro"; 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 - **Constructor visual de flujos de trabajo**: crea automatizaciones con una interfaz de arrastrar y soltar. No hace falta programar para la mayoría de las tareas. - **Más de 1 000 integraciones integradas**: conecta con Google Workspace, Microsoft 365, Slack, GitHub, bases de datos y APIs (más de 2 000 entradas en el [directorio de integraciones](https://n8n.io/integrations/) de n8n) - **Nodos de JavaScript personalizados**: escribe código cuando los nodos predefinidos no cubran tu caso de uso - **Soporte de webhooks**: dispara flujos de trabajo desde eventos externos: peticiones HTTP, cambios de archivos, llegada de correos - **Control avanzado del flujo**: lógica condicional, bucles, manejo de errores y procesamiento en paralelo - **Modo de cola**: distribuye el trabajo entre varios workers con PostgreSQL y Redis para operaciones de alto volumen - **Gestión de credenciales**: almacenamiento cifrado de claves API, tokens y datos de autenticación - **Privacidad del autoalojamiento**: mantén tus datos y la lógica de automatización en tus propios servidores - **API extensa**: gestiona flujos de trabajo y configuraciones mediante APIs REST - **Asistente de IA** (vista previa, 2.35+): construye flujos de trabajo con un asistente de IA usando tus propias claves API (Anthropic, OpenAI, OpenRouter) 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](https://github.com/n8n-io/n8n) o visitar [n8n.io](https://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. | Tipo de componente | Propósito | Casos de uso | |---------------|---------|-----------| | **Nodos trigger** | Inician la ejecución del flujo de trabajo | Peticiones webhook, tareas programadas, cambios de archivos, llegada de correos | | **Nodos regulares** | Realizan acciones | Llamadas a APIs, procesamiento de datos, operaciones con archivos | | **Nodos de control** | Gestionan la lógica del flujo | Ramificaciones condicionales, bucles, manejo de errores, combinación de datos | | **Nodos de código** | Ejecutan scripts personalizados | Cálculos complejos, transformaciones de datos | | **Nodos de sub-flujo** | Referencian otros flujos de trabajo | Componentes reutilizables, diseño modular | 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. n8n 3.0 eliminará el soporte para instalaciones con `npm` y `npx n8n`. Docker Compose será el único método de autoalojamiento soportado. Si hoy ejecutas n8n vía npm, migra a Docker ya. La versión 3.0 también elimina los nodos heredados Function/Function Item y el nodo AI Agent v1. Lee los [cambios disruptivos de la v3.0](https://docs.n8n.io/changelog/v30-breaking-changes) 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](https://docs.n8n.io/changelog/v20-breaking-changes) y los [cambios disruptivos de la v3.0](https://docs.n8n.io/changelog/v30-breaking-changes) 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:** | Componente | Mínimo | Recomendado | Modo de cola | |-----------|---------|-------------|------------| | **CPU** | 2 vCPU | 4 vCPU | 4+ vCPU | | **RAM** | 2 GB | 4 GB | 4 GB + 1 GB por worker | | **Almacenamiento** | 20 GB SSD | 50 GB SSD | 100 GB NVMe | | **Red** | 100 Mbps | 1 Gbps | 1 Gbps | El proceso de Node.js de n8n es de un solo hilo. Los flujos de trabajo complejos con grandes cargas JSON consumen memoria, no CPU. Si ves terminaciones por OOM, aumenta la RAM antes de añadir núcleos. **Prerrequisitos:** - **Un VPS con Linux**: se recomienda Ubuntu 22.04+. [Hetzner Cloud](https://go.bitdoze.com/hetzner) (4-8 €/mes) o [Hostinger VPS](https://go.bitdoze.com/hostinger-vps) funcionan bien, o usa un [mini PC como servidor doméstico](https://www.bitdoze.com/best-mini-pc-home-server/) - **Docker y Docker Compose** instalados en tu servidor - **Un nombre de dominio** con el DNS apuntando a tu servidor (p. ej., `n8n.yourdomain.com`) - **Un proxy inverso** para HTTPS: Traefik (consulta la [guía completa de Traefik como proxy inverso en Docker](https://www.bitdoze.com/traefik-proxy-docker/)) o deja que Dokploy lo gestione automáticamente _Los precios de los VPS subieron en general en 2026: si estás reconsiderando un servidor alquilado, mira [qué cambió y cuándo gana un mini PC](/es/subidas-precios-vps/)._ ## 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. La versión anterior de esta guía incluía Redis en el archivo compose independiente. Redis solo ayuda en modo de cola. Sin `EXECUTIONS_MODE=queue`, no hace nada salvo consumir ~100 MB de RAM. Esta configuración lo mantiene simple. ### Paso 1: crear el directorio del proyecto ```bash mkdir -p ~/n8n-automation && cd ~/n8n-automation ``` ### Paso 2: crear la configuración de Docker Compose ```yaml 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 ```bash # 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 ``` Si pierdes `N8N_ENCRYPTION_KEY`, todas las credenciales almacenadas se vuelven indescifrables. Haz copia de seguridad del archivo `.env` junto con tus datos. Si usas secretos de Docker o un gestor de `.env`, n8n admite variantes con sufijo `_FILE` (p. ej., `N8N_ENCRYPTION_KEY_FILE`). Consulta [secretos de Docker Compose y alternativas seguras](https://www.bitdoze.com/docker-compose-secrets/) para ver las opciones. ### Paso 4: lanzar y verificar ```bash # 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: ```bash 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`. `/healthz` devuelve 200 y los logs muestran "Editor is now accessible". Todo correcto. Para uso en producción, ponlo detrás de un proxy inverso (opción 2) o usa Dokploy (opción 3). ### 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. Necesitas Traefik funcionando con certificados wildcard. Sigue la [guía completa de Traefik como proxy inverso en Docker](https://www.bitdoze.com/traefik-proxy-docker/) y el [certificado wildcard gratuito de Let's Encrypt en Traefik con Cloudflare](https://www.bitdoze.com/traefik-wildcard-certificate/) para configurarlo primero. Puedes gestionar el stack con [Dockge, el gestor de Docker Compose para self-hosting](/es/instalar-dockge/). ### Paso 1: preparar la red de Traefik ```bash # 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 ```yaml 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