Infraestructura y nube 10 min

n8n autoalojado con Docker: lo que exige la producción

Un n8n autoalojado aguanta en producción con Docker Compose detrás de un proxy HTTPS, una versión fijada que se actualiza cuando usted lo decide y una restauración probada que devuelve la base de datos con su clave de cifrado. El RGPD sigue siendo cosa suya: en autoalojamiento, el editor no es ni responsable ni encargado del tratamiento de los datos de sus workflows.

Índice12
  1. 01¿Docker o Docker Compose?
  2. 02¿SQLite o PostgreSQL?
  3. 03La clave de cifrado, el secreto que nunca hay que perder
  4. 04¿Qué variables ajustar antes de pasar a producción?
  5. 05¿Cómo actualizar n8n sin romper la producción?
  6. 06¿Hay que pasar al modo cola?
  7. 07¿Qué no tiene su sitio en n8n?
  8. 08La telemetría: lo que va al editor
  9. 09El RGPD, de su cuenta
  10. 10Los límites honestos
  11. 11Por dónde empezar
  12. 12Preguntas frecuentes

Instalar un n8n autoalojado con Docker lleva unos pocos comandos, que la documentación de n8n sobre Docker Compose da paso a paso. Sin embargo, se abre con una advertencia: el editor recomienda el autoalojamiento a usuarios experimentados, porque un error puede costar datos, seguridad o tiempo de inactividad. Entre la instancia que arranca y aquella a la que se confían procesos reales quedan decisiones por tomar.

Hemos tomado varias para nuestro propio servidor, que ejecuta una docena de servicios en contenedores Docker detrás de un router Traefik. n8n ejecuta allí nuestros workflows de producción, entre ellos un agente de registro de gastos en Telegram y el que asigna un identificador interno a cada nuevo inmueble en el CRM de Palmora Property, un portal inmobiliario que operamos. Esta guía cruza la documentación del editor con esa explotación.

En resumen

  • Docker Compose detrás de un proxy HTTPS, con una versión fijada y un archivo de configuración versionado, sin los secretos.
  • La clave de cifrado protege sus credenciales: fíjela antes del primer arranque y guarde una copia fuera del servidor.
  • SQLite basta para probar; recomendamos PostgreSQL desde los primeros procesos de producción.
  • La telemetría está activa por defecto y se desactiva con variables de entorno, no en la interfaz.
  • En autoalojamiento, el RGPD corre de su cuenta: el editor no es ni responsable ni encargado del tratamiento de los datos de sus workflows.

¿Docker o Docker Compose?

La página de la documentación que instala n8n solo con Docker está marcada como obsoleta por el propio editor, que remite a Docker Compose: un solo archivo describe los contenedores, sus volúmenes y sus variables, y se versiona como código.

El modelo del editor plantea dos contenedores, n8n y un proxy, y guarda los datos en un volumen:

El modelo Docker Compose del editor

  1. El proxy

    Traefik obtiene los certificados y redirige todo a HTTPS. Solo el proxy está expuesto.

  2. n8n

    El puerto de n8n solo escucha en la propia máquina (127.0.0.1:5678).

  3. Los datos

    El volumen n8n_data, montado en /home/node/.n8n, contiene la base SQLite y la clave de cifrado de n8n.

Dos añadidos al modelo: guarde los secretos (contraseña de la base, clave de cifrado) en un archivo de entorno que no vaya al repositorio, y sustituya la imagen que sigue la última versión por una versión precisa.

¿SQLite o PostgreSQL?

Sin ajustes, n8n guarda sus workflows, sus credenciales y el historial de ejecuciones en una base SQLite, un archivo dentro de su volumen. La documentación de la instalación con Docker explica el paso a PostgreSQL: la variable DB_TYPE=postgresdb y las variables DB_POSTGRESDB_* (host, base, usuario, contraseña). Recomienda conservar la carpeta /home/node/.n8n incluso con PostgreSQL: contiene otros datos importantes, entre ellos las claves de cifrado y los registros de la instancia.

SQLite basta para probar n8n en una instancia única. En cuanto el trabajo se reparte entre varios procesos, la documentación del modo cola desaconseja SQLite y no da soporte a un sistema distribuido que se apoye en ella. Recomendamos PostgreSQL en cuanto una instancia lleva procesos de producción: la base se respalda con sus propias herramientas, como detallamos en nuestra guía de copias de seguridad de un servidor propio, y el paso al modo cola, si llega un día, no exigirá cambiar de base.

La clave de cifrado, el secreto que nunca hay que perder

n8n cifra las credenciales que le confía (claves de API, contraseñas de los servicios conectados) antes de guardarlas en la base. Según la documentación sobre la clave de cifrado, crea una clave aleatoria en el primer arranque y la guarda en su carpeta de datos; se puede fijar una propia con la variable N8N_ENCRYPTION_KEY, siempre que la clave no figure ya en el archivo de ajustes. Fíjela, pues, antes del primer arranque, y guarde una copia en un gestor de secretos, fuera del servidor.

Atención

Una restauración exige las dos cosas, la base y la clave

Sin la clave, las credenciales guardadas ya no pueden descifrarse, y habría que recrearlas una a una.

¿Qué variables ajustar antes de pasar a producción?

El modelo del editor ajusta una parte. Estas son las que conviene comprobar antes del primer proceso real, según la documentación de n8n sobre los webhooks detrás de un proxy, la zona horaria y los datos de ejecución.

VariableLo que ajustaPor qué pensar en ella
N8N_WEBHOOK_URLLa dirección pública de los webhooksDetrás de un proxy, la dirección que n8n calcula solo es errónea; sustituye a WEBHOOK_URL, obsoleta desde la versión 2.35.0, que el modelo Compose todavía usa
N8N_PROXY_HOPSEl número de proxys delante de n8nA 1 detrás de un único proxy, que debe transmitir las cabeceras X-Forwarded-For, X-Forwarded-Host y X-Forwarded-Proto
GENERIC_TIMEZONELa zona horaria de la instanciaSin ella, el nodo Schedule sigue la hora de Nueva York
N8N_ENCRYPTION_KEYLa clave de cifradoVéase más arriba
EXECUTIONS_DATA_SAVE_ON_SUCCESSLo que se conserva de las ejecuciones correctasEn none, ya no se guardan, lo que aligera la base y los datos personales conservados

¿Cómo actualizar n8n sin romper la producción?

Según su documentación de Docker Compose, n8n publica una nueva versión menor casi todas las semanas: la estable sirve para producción, la beta es más reciente y puede ser inestable. Una imagen que sigue la última versión puede hacerle subir varias versiones de golpe sin haberlo decidido. Recomendamos cuatro pasos:

  1. Fije una versión precisa.

    El archivo Compose fija el número de versión, en lugar de seguir la última.

  2. Lea las notas de versión.

    El paso a una versión mayor es el que exige más atención: la 2.0, por ejemplo, desactivó por defecto el nodo Execute Command.

  3. Respalde la base y compruebe la clave.

    Una copia hecha justo antes de la actualización permite volver atrás.

  4. Actualice y luego verifique.

    La documentación encadena docker compose pull, docker compose down y después docker compose up -d. Abra luego un workflow crítico y observe su siguiente ejecución.

Y nunca una limpieza global del servidor en esa ocasión: fue un comando de ese tipo el que eliminó en nuestra casa los contenedores de diez servicios en julio de 2026.

¿Hay que pasar al modo cola?

El modo cola reparte las ejecuciones entre varios workers mediante una cola gestionada por Redis. Según su documentación, exige EXECUTIONS_MODE=queue y la misma clave de cifrado en cada proceso y, si sus workflows deben conservar archivos, un almacenamiento externo de tipo S3: este modo no admite su almacenamiento en el disco del servidor.

Empiece por una instancia única bien ajustada, y no divida hasta haber medido lo que ralentiza.

¿Qué no tiene su sitio en n8n?

Con Docker, el nodo Execute Command lanza sus comandos en el contenedor de n8n, no en el servidor, y está desactivado por defecto desde la versión 2.0. El contenedor solo ve las carpetas que se le han montado. Abrirle el acceso al servidor, por ejemplo al motor de Docker, daría ese poder a cada workflow y a cada persona que pueda modificar uno.

De ahí la regla que recomendamos: las tareas que necesitan las herramientas del servidor (copias de seguridad, limpiezas, scripts que publican un sitio) van al planificador del servidor o a la integración continua, no a n8n.

Sobre el terreno

La sincronización diaria de los inmuebles de Palmora Property se ejecuta en el planificador de un servidor, con una relanzada manual desde la integración continua.

n8n conserva lo que mejor hace: conectar servicios a través de sus API.

La telemetría: lo que va al editor

Según su página sobre privacidad, n8n nunca recibe los datos de sus workflows cuando usted lo aloja. Su telemetría, activa por defecto y presentada como seudónima (vinculada a un código, no a su nombre), incluye en particular una dirección IP truncada, el dominio principal de las direcciones llamadas por los nodos HTTP Request y de las llamadas a webhooks, sin subdominio ni ruta, e información sobre la instancia, el uso y los errores. La página sobre la telemetría añade el número de ejecuciones y una señal de la instancia cada seis horas.

No hay interruptor en la interfaz: todo se desactiva con variables de entorno, reunidas en la guía para aislar una instancia. Con una licencia de pago, la instancia sigue declarando sus volúmenes de uso y su identificador de licencia, y eso no se desactiva. Seguir esa guía también desactiva el aviso de nuevas versiones en la interfaz: vigilar las notas de versión pasa a ser su trabajo.

El RGPD, de su cuenta

La página sobre privacidad lo dice sin rodeos:

For self-hosted versions, n8n is neither a Controller nor a Processor, as we don’t manage your data.

Documentación de n8n, página sobre privacidad (original en inglés)

La misma página hace una excepción para la telemetría: n8n es responsable del tratamiento de los datos de uso y de diagnóstico que su instancia le envía.

Cuatro puntos exigen, pues, una decisión por su parte.

  • El historial de ejecuciones guarda datos personales. Para borrar los de una persona, n8n indica eliminar las ejecuciones que le conciernen y recomienda configurar su purga; nuestra guía para supervisar n8n en producción detalla lo que guarda y durante cuánto tiempo.
  • El enmascaramiento de los datos de ejecución está reservado a la edición Enterprise en autoalojamiento, según su documentación: sin él, el historial sigue legible para quien tenga acceso.
  • Cada servicio llamado recibe datos. Una API de modelo de IA o una herramienta de emailing es un encargado más, con su contrato.
  • El registro y los contratos. El tratamiento entra en su registro de actividades de tratamiento, y el proveedor de alojamiento de su servidor es un encargado, al que hay que vincular con un contrato conforme al artículo 28 del RGPD. La CNIL, la autoridad francesa de protección de datos, desaconseja en su ficha sobre la subcontratación recurrir a servicios en la nube sin garantía sobre la ubicación geográfica efectiva de los datos.

Esta guía dice dónde mirar; no sustituye a un asesoramiento jurídico sobre su tratamiento.

Los límites honestos

  • El autoalojamiento desplaza el coste, no lo elimina: el servidor, las copias, actualizaciones frecuentes y alguien que vigile.
  • Ninguna garantía de disponibilidad de un editor: de noche, avisa su alerta, o nadie.
  • La edición Community no incluye ni SSO ni el uso compartido de workflows: detallamos lo que permite la licencia de n8n.

Por dónde empezar

Empiece por un inventario: los procesos que llevará n8n, los datos que tocan y quién recibe las alertas. Después, por orden: el archivo Compose versionado y la clave fuera del servidor, la base, las variables, la decisión sobre la telemetría y una primera restauración probada antes del primer proceso en producción.

Si n8n es solo una de las herramientas que instalar, nuestra guía de la base de infraestructura común a sus proyectos fija el marco; si aún duda en alojarlo, lea nuestra comparativa de n8n, Make y Zapier. Para un servidor instalado, respaldado y supervisado, nuestra salida del SaaS instala hasta cinco herramientas, con la gestión externalizada como opción; si lo que hay que construir son los propios procesos, es nuestra oferta de automatización.

Preguntas frecuentes

¿Dónde está la clave de cifrado de n8n?

n8n la crea en el primer arranque y la guarda en su carpeta de datos, el volumen n8n_data en el modelo Docker Compose del editor. Fije la suya con la variable N8N_ENCRYPTION_KEY antes de ese primer arranque y guarde una copia fuera del servidor: una base restaurada sin su clave ya no permite leer las credenciales guardadas.

¿SQLite o PostgreSQL para n8n en producción?

SQLite, la base por defecto, basta para probar n8n en una instancia única. El modo cola, que reparte el trabajo entre varios procesos, la desaconseja, y n8n no da soporte a un sistema distribuido que se apoye en ella. Recomendamos PostgreSQL desde los primeros procesos de producción, respaldado con sus propias herramientas.

¿Cómo actualizar n8n instalado con Docker?

La documentación encadena tres comandos: docker compose pull, docker compose down y después docker compose up -d. Antes, lea las notas de versión, respalde la base y compruebe que la clave de cifrado está a buen recaudo. Una versión fijada convierte cada actualización en un cambio decidido, y la copia de seguridad permite volver atrás.

¿Hay que desactivar la telemetría de n8n?

Es una decisión, no una obligación. n8n la presenta como seudónima: una dirección IP truncada, el dominio de los servicios llamados, el uso y los errores, nunca los datos de los workflows. Se desactiva con variables de entorno; con una licencia de pago, la declaración de uso ligada a la licencia sigue activa. Anote su elección junto con la configuración de la instancia.

Fuentes

  1. Documentación de n8n sobre Docker Compose (nueva pestaña)docs.n8n.io
  2. Instala n8n solo con Docker (nueva pestaña)docs.n8n.io
  3. La documentación del modo cola (nueva pestaña)docs.n8n.io
  4. La documentación sobre la clave de cifrado (nueva pestaña)docs.n8n.io
  5. Los webhooks detrás de un proxy (nueva pestaña)docs.n8n.io
  6. La zona horaria (nueva pestaña)docs.n8n.io
  7. Los datos de ejecución (nueva pestaña)docs.n8n.io
  8. El nodo Execute Command (nueva pestaña)docs.n8n.io
  9. Su página sobre privacidad (nueva pestaña)docs.n8n.io
  10. La página sobre la telemetría (nueva pestaña)docs.n8n.io
  11. La guía para aislar una instancia (nueva pestaña)docs.n8n.io
  12. Su documentación (nueva pestaña)docs.n8n.io
  13. Registro de actividades de tratamiento (nueva pestaña)cnil.fr
  14. Su ficha sobre la subcontratación (nueva pestaña)cnil.fr
Fuente 1

Documentación de n8n sobre Docker Compose

Leer en docs.n8n.io(nueva pestaña)
Fuente 2

Instala n8n solo con Docker

Leer en docs.n8n.io(nueva pestaña)
Fuente 3

La documentación del modo cola

Leer en docs.n8n.io(nueva pestaña)
Fuente 4

La documentación sobre la clave de cifrado

Leer en docs.n8n.io(nueva pestaña)
Fuente 5

Los webhooks detrás de un proxy

Leer en docs.n8n.io(nueva pestaña)
Fuente 7

Los datos de ejecución

Leer en docs.n8n.io(nueva pestaña)
Fuente 8

El nodo Execute Command

Leer en docs.n8n.io(nueva pestaña)
Fuente 9

Su página sobre privacidad

Leer en docs.n8n.io(nueva pestaña)
Fuente 10

La página sobre la telemetría

Leer en docs.n8n.io(nueva pestaña)
Fuente 11

La guía para aislar una instancia

Leer en docs.n8n.io(nueva pestaña)
Fuente 12

Su documentación

Leer en docs.n8n.io(nueva pestaña)
Fuente 13

Registro de actividades de tratamiento

Leer en cnil.fr(nueva pestaña)
Fuente 14

Su ficha sobre la subcontratación

Leer en cnil.fr(nueva pestaña)

Jim · fundador de Brain Plus AI

Más artículos sobre infraestructura y nube

  • Guía práctica8 min

    Hacer copias de un servidor propio: lo que falla de verdad

    Todo el mundo conoce la regla 3-2-1, pero lo que hace perder datos es más banal: una copia de seguridad nunca restaurada, un volumen olvidado, una orden de limpieza global lanzada en producción. Esto es lo que hemos aprendido explotando nuestro propio servidor.

  • Entender9 min

    Licencia de n8n: lo que permite la Sustainable Use License

    n8n no es open source en sentido estricto: se distribuye bajo la Sustainable Use License. Esto es lo que permite a una pyme que automatiza sus procesos y a su proveedor, y lo que prohíbe a quien quiera revender un servicio construido sobre n8n.

  • Entender10 min

    Coste de la nube: las cinco partidas que inflan la factura

    Una factura de la nube casi nunca se dispara de golpe: crece por partidas que nadie mira. Las cinco que más pesan, lo que las hace invisibles y la rutina que las mantiene bajo control sin frenar los proyectos.

WhatsApp