Cómo instalar n8n con Docker Compose: Postgres en lugar de SQLite, .env, volúmenes y actualizaciones paso a paso.
n8n se puede instalar en un servidor propio con Docker Compose en pocos pasos: crea un archivo compose y un archivo .env con las credenciales, define un volumen para los datos persistentes e inicia la pila con un único comando. Para el uso en producción, la mayoría de los operadores cambian de la base de datos SQLite incluida a PostgreSQL, porque varios workflows en ejecución simultánea y las copias de seguridad periódicas funcionan así de forma más fiable. Este artículo muestra la estructura del archivo compose, las variables de entorno necesarias, los volúmenes y el proceso de actualización. Actualizado: julio de 2026.
La instalación se realiza mediante un archivo compose.yaml que inicia el contenedor de n8n, combinado con un archivo .env para los valores específicos del servidor. En un servidor Linux, compruebe primero si Docker y Docker Compose están instalados, por ejemplo con los comandos docker --version y docker compose version. A continuación, cree un directorio de proyecto con el compose.yaml, el archivo .env y una subcarpeta local-files para el intercambio de archivos entre n8n y el host. El inicio se realiza con el comando docker compose up -d, tras lo cual n8n es accesible a través del dominio configurado o, en una instalación sencilla de un solo contenedor sin reverse proxy, en http://localhost:5678. La documentación oficial de n8n ofrece para ello una configuración lista para usar con Docker Compose, que además incluye Traefik como reverse proxy para los certificados TLS.
Por defecto, n8n utiliza SQLite y almacena las credenciales, los workflows y el historial de ejecución sin configuración adicional en el archivo database.sqlite del directorio .n8n. Para cambiar a PostgreSQL, defina las variables de entorno adecuadas en el archivo compose, tal como se describe en la documentación sobre la selección de la base de datos.
Importante: incluso con PostgreSQL, el volumen para el directorio /home/node/.n8n sigue siendo necesario, porque allí se sigue almacenando la clave de cifrado de las credenciales.
El archivo .env agrupa todos los valores que difieren de un servidor a otro, para que el propio compose.yaml permanezca sin cambios. Según la guía oficial sobre la instalación con Docker, al menos las siguientes variables deben estar allí.
Dado que este archivo contiene contraseñas y credenciales, no debe estar en un repositorio Git público.
Para un funcionamiento permanente, son relevantes varias ubicaciones de almacenamiento que deben conservarse en cada reinicio.
Sin estos volúmenes, los workflows, las credenciales y los certificados se pierden cada vez que se reconstruye el contenedor.
Una actualización se realiza mediante tres comandos en el directorio del archivo compose: docker compose pull descarga la nueva versión de la imagen, docker compose down detiene la pila en ejecución y docker compose up -d la reinicia con la imagen actual. Los volúmenes no se ven afectados, por lo que los workflows y las credenciales se conservan. Quien desee fijar una versión concreta en lugar de actualizar automáticamente a la última versión estable, puede indicar una etiqueta de versión concreta en el compose.yaml, según la documentación por ejemplo docker.n8n.io/n8nio/n8n:1.81.0, en lugar de la etiqueta next para versiones beta inestables. Quien quiera una configuración limpia desde el principio, mejor planifica minuciosamente una vez en lugar de reparar problemas del servidor más adelante. Exactamente eso es lo que se encarga de hacer NordFlux en el marco de la configuración de n8n a precio fijo, incluida la decisión entre SQLite y PostgreSQL adecuada al uso real.
No, no es obligatorio. Para una instalación sencilla de un solo contenedor, basta con un volumen mapeado y el puerto 5678, n8n es entonces accesible localmente en http://localhost:5678. Un dominio solo es necesario si desea utilizar la configuración descrita en la guía oficial con Traefik como reverse proxy y un certificado TLS automático.
Todo se encuentra en el volumen montado que apunta al directorio /home/node/.n8n dentro del contenedor. Allí se encuentra el archivo de base de datos si se usa SQLite, y, independientemente de la base de datos elegida, también la clave de cifrado de las credenciales almacenadas. Sin este volumen, todos los datos se pierden en el próximo reinicio del contenedor.
La secuencia docker compose pull, docker compose down y docker compose up -d actualiza la imagen sin tocar los volúmenes. Como los workflows, las credenciales y la base de datos se encuentran en los volúmenes, se conservan durante la actualización. Antes de saltos de versión importantes, no obstante, merece la pena revisar las notas de la versión, porque las variables de entorno pueden cambiar entre versiones.
Sí, las imágenes de Docker se publican con diferentes etiquetas. Una etiqueta de versión concreta como 1.81.0 fija una versión estable, mientras que la etiqueta next ofrece la versión beta inestable para quienes desean probar nuevas funciones de antemano. Para servidores de producción, una etiqueta de versión fija es la opción más fiable.
Fundador de NordFlux. Siete años de experiencia, desde la web y el SEO hasta la automatización a escala de grupo, hoy de forma pragmática para las pymes y con soberanía de datos alemana.
Certificaciones
Instalar n8n en Hetzner: tipo de servidor, Docker Compose con Caddy y por qué la ubicación alemana del servidor cuenta para una automatización conforme al RGPD.
El Self-hosted AI Starter Kit de n8n inicia n8n, Ollama, Qdrant y PostgreSQL mediante Docker Compose para workflows de IA locales sin API en la nube.
npm, Docker o app de escritorio: como probar n8n en local, que diferencias hay en persistencia y esfuerzo, y por que la app de escritorio ya no existe.
Postgres en lugar de SQLite, un archivo .env limpio y volúmenes correctamente definidos son la base, pero solo la operación continua con actualizaciones y copias de seguridad determina la fiabilidad real. NordFlux se encarga de la operación gestionada de n8n en su infraestructura Docker, con monitorización, actualizaciones y copias de seguridad probadas en lugar de mantenimiento improvisado. En la primera conversación revisamos su configuración actual y mostramos los mayores riesgos operativos.
