Clase 02 · Módulo 14
Desplegar n8n en un servidor con Docker
Desplegar n8n en un servidor con Docker
Qué logras en esta clase
Dejas n8n corriendo en un servidor, con base Postgres, dominio propio y HTTPS.
- Entiendes cada pieza del archivo Compose.
- Defines las variables que no pueden faltar.
- Compruebas que los webhooks muestran tu dominio.
02
Las piezas del despliegue
- Dominio: el nombre que escribe la gente y los servicios.
- Proxy inverso: programa que recibe el tráfico cifrado y lo pasa a n8n.
- n8n: el contenedor con tu instancia.
- Postgres: la base donde n8n guarda flujos, credenciales y ejecuciones.
03
Lo que necesitas antes
- Un servidor Linux con Docker y Docker Compose instalados.
- Acceso por terminal (SSH) a ese servidor.
- Un dominio o subdominio que puedas apuntar a la dirección IP del servidor.
- Haber hecho el módulo 2, clase 3: Docker ya no es nuevo para ti.
Para instalar Docker en el servidor sigue la guía oficial de Docker para tu distribución.
04
Por qué Compose y no un comando suelto
n8n recomienda Docker Compose: todos los contenedores descritos en un archivo de texto. Lo que está escrito se puede repetir, respaldar y revisar.
05
Parte del ejemplo oficial
n8n mantiene archivos de ejemplo en el repositorio n8n-hosting. El de Postgres está en docker-compose/withPostgres.
- Abre el repositorio y lee el archivo completo.
- Cópialo a una carpeta propia en el servidor.
- Pídele a Claude que te explique cada línea antes de cambiar algo.
06
Por qué Postgres en producción
| SQLite | Postgres | |
|---|---|---|
| Qué es | Un archivo dentro del volumen | Un servidor de base de datos |
| Conviene para | Aprender, uso liviano | Uso continuo con muchas ejecuciones |
| Respaldo | Copiar el archivo | Volcado de la base |
Desde n8n 2.0, MySQL y MariaDB ya no se aceptan como base de la instancia.
07
Las variables de la base
Le dicen a n8n dónde está Postgres y cómo entrar:
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=una-clave-largaEl HOST es el nombre del servicio de Postgres dentro del archivo Compose. Existe también DB_POSTGRESDB_SCHEMA si usas un esquema distinto al normal.
08
Zona horaria: dos variables
TZ=America/Santiago
GENERIC_TIMEZONE=America/SantiagoTZfija la hora del sistema dentro del contenedor.GENERIC_TIMEZONEfija la que usan los nodos de horario, como Schedule Trigger.
09
La clave de cifrado se fija, no se deja al azar
Si no defines N8N_ENCRYPTION_KEY, n8n genera una en el primer arranque y la guarda en el volumen.
En producción, créala tú: una cadena aleatoria larga, puesta en el archivo .env y copiada además en tu gestor de contraseñas.
Sin esa clave, las credenciales guardadas no se pueden descifrar (módulo 2, clase 6).
10
La dirección pública: N8N_WEBHOOK_URL
n8n necesita saber con qué dirección lo ven desde afuera. Con eso arma las direcciones de los webhooks y los retornos de OAuth.
N8N_WEBHOOK_URL=https://n8n.tudominio.cl/
N8N_PROXY_HOPS=1N8N_PROXY_HOPS=1 le avisa que hay un proxy delante. Confirma el detalle de ambas en la referencia de variables de entorno de docs.n8n.io.
11
El nombre antiguo quedó obsoleto
12
Qué va en el .env
El archivo .env vive junto al Compose y guarda los valores secretos: clave de la base, clave de cifrado, dominio.
- Las líneas que empiezan con
#son comentarios. - Desde 2.0, un valor con comillas invertidas debe ir entre comillas.
- Nunca se sube a un repositorio.
El Compose lee esos valores por su nombre, así el archivo principal queda sin secretos.
13
Fija la versión de la imagen
image: n8nio/n8n:2.48.4Las etiquetas móviles son stable y beta; latest y next son los nombres antiguos. Con una etiqueta móvil, un reinicio puede subirte de versión sin aviso.
La recomendación oficial es escribir la versión exacta. La estable de hoy la ves en docs.n8n.io/release-notes.
14
Los volúmenes guardan lo que importa
Un contenedor se puede borrar y recrear. Lo que debe sobrevivir va en volúmenes:
| Volumen | Contiene |
|---|---|
El de n8n, montado en /home/node/.n8n | Clave de cifrado, registros |
| El de Postgres | Toda la base |
Aun con Postgres, el volumen de n8n se conserva.
15
Dominio y HTTPS
- En tu proveedor de dominio, crea un registro A que apunte el subdominio a la IP del servidor.
- Pon delante de n8n un proxy inverso que obtenga y renueve el certificado.
- Deja abiertos al exterior solo los puertos web y el de SSH.
Caddy y Traefik son proxies de uso común que gestionan certificados solos. La configuración concreta está en la documentación de cada uno.
16
El puerto 5678 no se publica
n8n escucha en el puerto 5678 sin cifrar. Solo el proxy debe hablar con ese puerto.
17
La alternativa sin proxy: un túnel
Si no quieres administrar certificados ni abrir puertos, un túnel de Cloudflare con nombre hace el mismo trabajo: conecta tu dominio con el n8n del servidor desde adentro hacia afuera.
Se arma igual que en la clase 3. Sirve tanto en un servidor arrendado como en tu computador.
18
Levantar y mirar
Desde la carpeta del Compose:
docker compose up -d
docker compose ps
docker compose logs -f n8n- El primero descarga las imágenes y arranca todo en segundo plano.
- El segundo muestra si los contenedores están arriba.
- El tercero muestra lo que n8n va diciendo. Sales con Ctrl+C.
19
Comprobar que quedó bien
- Abre
https://más tu dominio: debe cargar sin advertencias del navegador. - Crea la cuenta de propietario.
- Agrega un nodo Webhook: su Production URL debe empezar con tu dominio.
- Publica un flujo de prueba y llama esa dirección desde tu celular.
- Reinicia el servidor y confirma que n8n vuelve solo.
20
Tres fallas típicas del primer día
| Síntoma | Causa probable |
|---|---|
Webhooks muestran localhost | Falta N8N_WEBHOOK_URL o su valor no es tu dominio |
| Credenciales que no abren tras recrear | Cambió la clave de cifrado |
| OAuth no vuelve a n8n | Dirección pública mal puesta o sin sesión iniciada |
Desde 2.0 el retorno de OAuth exige sesión abierta: conecta desde el mismo navegador donde estás dentro de n8n.
21
Si usas el servidor MCP
22
Lo que te llevas
- Compose con dos servicios: n8n y Postgres, cada uno con su volumen.
- Variables mínimas: zona horaria,
DB_*,N8N_ENCRYPTION_KEYyN8N_WEBHOOK_URL. WEBHOOK_URLes el nombre obsoleto.- Versión exacta en la imagen, secretos en
.env, puerto 5678 cerrado al exterior. - No está listo hasta que un webhook de producción responde desde tu dominio.
23
Hazlo ahora
En 15 minutos, sin servidor todavía:
- Abre el ejemplo
withPostgresdel repositorion8n-hosting. - Marca en el archivo dónde aparece cada variable de esta clase.
- Anota cuáles faltan y dónde las agregarías.
- Escribe en un borrador la lista de valores que irán a tu
.env, sin los secretos reales.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Docker installation (documentación de n8n)docs.n8n.io ↗
- Repositorio n8n-hosting (archivos Compose de ejemplo)github.com ↗
- n8n v2.0 breaking changesdocs.n8n.io ↗
- Encryption key (documentación de n8n)docs.n8n.io ↗
- Accessing the n8n MCP server (cabeceras y proxy)docs.n8n.io ↗
- n8n release notesdocs.n8n.io ↗
- n8n Docs — Variables de entorno de endpoints (N8N_WEBHOOK_URL)docs.n8n.io ↗
- n8n Docs — Variables de zona horaria (GENERIC_TIMEZONE)docs.n8n.io ↗