Clase 03 · Módulo 02
Instalar n8n con Docker
Instalar n8n con Docker
Qué logras en esta clase
Levantas n8n dentro de Docker sin perder datos al reiniciar.
- Entiendes imagen, contenedor y volumen.
- Arrancas n8n con un comando y luego con un archivo Compose.
- Fijas la versión y actualizas sin sorpresas.
02
Qué es Docker
Docker es un programa que ejecuta otros programas dentro de contenedores: cajas cerradas que traen adentro todo lo que el programa necesita.
Para n8n significa que no dependes del Node de tu computador. La caja ya trae el suyo, en la versión correcta.
Lo que funciona en tu contenedor funciona igual en un servidor.
03
Tres palabras que necesitas
| Palabra | Qué es | Comparación |
|---|---|---|
| Imagen | El molde: n8n ya empaquetado | El instalador |
| Contenedor | Una copia de la imagen, corriendo | El programa abierto |
| Volumen | Un espacio de disco fuera del contenedor | Tu carpeta de documentos |
La imagen oficial se llama n8nio/n8n.
04
La regla que evita perder todo
El contenedor es desechable: se borra y se crea otro igual. El volumen no: ahí viven tus flujos y tus credenciales.
05
Por qué Docker si ya tienes npm
- Es el método que la documentación de n8n recomienda.
- La instalación con npm queda obsoleta desde n8n 3.0.
- Actualizar es cambiar de imagen, no reinstalar.
- Tu equipo y el servidor del módulo 14 quedan armados igual.
Lo malo: hay un concepto más que aprender y Docker ocupa memoria aunque n8n esté quieto.
06
Instalar Docker Desktop
Docker Desktop es la aplicación para Windows, Mac y Linux. Incluye el motor de Docker y Compose, la herramienta que usarás más adelante en esta clase.
- Descárgala desde docker.com, el sitio oficial.
- Instálala siguiendo su asistente; puede pedir reiniciar.
- Ábrela y espera a que indique que el motor está corriendo.
- En la terminal, comprueba con
docker --version.
07
Crear el volumen y arrancar
Con Docker Desktop abierto, en la terminal:
docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 \
-e GENERIC_TIMEZONE="America/Santiago" -e TZ="America/Santiago" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-v n8n_data:/home/node/.n8n n8nio/n8nLa primera vez descarga la imagen. Cuando termine, abre http://localhost:5678.
08
Qué dice cada parte del comando
| Parte | Qué hace |
|---|---|
--name n8n | Le pone nombre al contenedor |
-p 5678:5678 | Conecta el puerto del contenedor con el de tu equipo |
-e ... | Define una variable de entorno |
-v n8n_data:... | Monta el volumen donde n8n guarda sus datos |
--rm | Borra el contenedor al detenerlo |
-it | Muestra los mensajes en tu terminal |
09
En Windows, una sola línea
Detienes el contenedor con Ctrl + C en esa terminal, igual que con npm.
10
Cómo quedan conectadas las piezas
Borra el contenedor y vuelve a crearlo: abre igual, porque los datos nunca estuvieron adentro.
11
Las dos variables de hora
TZfija la zona horaria del sistema dentro del contenedor.GENERIC_TIMEZONEfija la que usan los nodos de horario, como Schedule Trigger.
Define las dos con el mismo valor. Sin ellas, n8n usa la hora de Nueva York y tus flujos programados corren desfasados.
12
Qué guarda el volumen
El volumen queda montado en /home/node/.n8n, la carpeta de datos de n8n dentro del contenedor. Con la base por defecto (SQLite, una base en un solo archivo) contiene:
- Flujos, credenciales y ejecuciones.
- La clave de cifrado.
- Los registros.
Si más adelante usas Postgres como base, el volumen sigue guardando la clave y los registros.
13
Sin volumen, pierdes todo
14
De un comando a un archivo
El comando largo sirve para probar. Para el día a día conviene Docker Compose: escribes la configuración una vez en un archivo y la levantas con una orden corta.
Ventajas:
- No dependes de recordar el comando.
- El archivo se respalda y se lleva al servidor.
- Cambiar una variable es editar una línea.
15
Un archivo Compose mínimo
En una carpeta nueva, crea compose.yaml, un archivo de texto en formato YAML:
services:
n8n:
image: n8nio/n8n:2.48.4
restart: always
ports:
- "127.0.0.1:5678:5678"
environment:
- GENERIC_TIMEZONE=America/Santiago
- TZ=America/Santiago
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
external: trueLa sangría importa: se hace con espacios, no con tabulaciones.
16
Lo que cambia respecto del comando
imagelleva una versión exacta (la del ejemplo es la estable al 18-11-2026).restart: alwaysvuelve a levantar n8n si se cae o reinicias el equipo.127.0.0.1deja el editor accesible solo desde tu computador.external: truereutiliza el volumen que ya creaste, con tus datos.
17
Levantar y detener con Compose
Desde la carpeta donde está el archivo:
docker compose up -d
docker compose stopup -d lo deja corriendo en segundo plano: puedes cerrar la terminal. stop lo detiene sin borrar nada.
18
Compose es tu configuración escrita
Un archivo compose.yaml es la receta de tu instalación. Con el archivo y el volumen, reconstruyes n8n en cualquier equipo.
19
Qué versión poner en la imagen
| Etiqueta | Qué trae | Cuándo |
|---|---|---|
| Versión exacta | Siempre la misma | Recomendado |
stable | La estable del momento | Para probar rápido |
beta | La más nueva, puede fallar | Solo para experimentar |
En la 2.0 las etiquetas latest y next pasaron a llamarse stable y beta. Algunos ejemplos antiguos todavía muestran los nombres viejos.
20
Actualizar con Compose
- Lee las notas en docs.n8n.io/release-notes.
- Cambia el número de versión en
compose.yaml. - Ejecuta, en orden:
docker compose pull
docker compose down
docker compose up -dpull descarga la imagen nueva, down quita el contenedor viejo y up crea el nuevo. El volumen no se toca.
21
npm y Docker a la vez no
Elige una para seguir el curso. La recomendada es Docker.
22
Lo que falta para un servidor
Lo de hoy corre en tu equipo y solo tú lo ves. Para producción se agregan piezas que verás en el módulo 14:
- Postgres como base de datos en vez de SQLite.
- Un dominio y conexión cifrada (HTTPS) mediante un proxy, el programa que recibe las visitas y las pasa a n8n.
- La clave de cifrado fijada por ti (clase 6).
El archivo Compose crece, pero la lógica es la misma.
23
Cuando no levanta
| Lo que ves | Causa probable |
|---|---|
No reconoce docker | Docker Desktop no está instalado o abierto |
| Puerto 5678 ocupado | Otro n8n sigue corriendo |
| Error al leer el archivo | Sangría mal puesta en el YAML |
| No encuentra el volumen | Falta docker volume create n8n_data |
24
Lo que te llevas
- Imagen es el molde, contenedor es el programa corriendo, volumen son tus datos.
- Sin volumen montado en
/home/node/.n8n, los datos se pierden. - Compose deja tu instalación escrita en un archivo.
- Fija una versión exacta y actualiza con
pull,down,up -d. - Es el mismo método que usarás en el servidor.
25
Hazlo ahora
En 15 minutos:
- Instala Docker Desktop y comprueba
docker --version. - Crea el volumen
n8n_data. - Arma el
compose.yamlcon la versión estable de hoy. - Ejecuta
docker compose up -dy abrehttp://localhost:5678. - Ejecuta
docker compose downy luegoup -d: confirma que n8n abre igual.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026