Cómo instalar n8n en Windows con Docker: guía paso a paso

Nivel: principiante · Sistema: Windows · Entorno: aprendizaje local

Instalar n8n en tu ordenador te permite aprender a crear flujos a tu ritmo. En esta guía prepararás una instalación local con Docker Desktop, abrirás el editor y comprobarás un primer flujo sin conectar cuentas externas.

El objetivo es aprender. Si apagas o suspendes el ordenador, las automatizaciones dejan de ejecutarse. Un servicio que deba funcionar las 24 horas necesita otro planteamiento.

Antes de empezar

Necesitas una versión de Windows compatible con Docker Desktop, conexión a internet y virtualización habilitada. Consulta los requisitos actuales y descarga el instalador desde la guía oficial de Docker para Windows. La disponibilidad y las condiciones de Docker Desktop dependen de tu uso; revísalas durante la instalación.

1. Instala y abre Docker Desktop

Sigue el instalador oficial y utiliza el motor WSL 2. Completa los pasos de WSL que indique Docker y reinicia si te lo solicita. Abre Docker Desktop y espera a que el motor esté preparado. n8n utiliza contenedores Linux.

Abre PowerShell y comprueba que Docker responde:

docker version
docker compose version

Si no aparece información del servidor de Docker, comprueba que Docker Desktop esté abierto antes de continuar.

2. Prepara una carpeta para el proyecto

Para este ejemplo usaremos un archivo de configuración y un volumen administrado por Docker. En PowerShell ejecuta, una línea cada vez:

mkdir "$HOME\n8n-local"
cd "$HOME\n8n-local"
notepad compose.yaml

Si la carpeta ya existe, entra en ella sin volver a crearla. En el Bloc de notas pega la siguiente configuración y guarda el archivo como compose.yaml, sin añadir .txt. Es una configuración mínima para practicar; no incluye n8n Assistant ni su infraestructura adicional.

services:
  n8n:
    image: n8nio/n8n:stable
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - TZ=Europe/Madrid
      - GENERIC_TIMEZONE=Europe/Madrid
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

El puerto queda vinculado a tu ordenador y el volumen conserva los datos de n8n. Si vives en otra zona horaria, cambia Europe/Madrid. Esta adaptación combina la configuración Docker de n8n con Compose; consulta también la guía oficial de Compose para instalaciones más completas.

3. Arranca n8n y abre el editor

Desde la carpeta donde guardaste el archivo, ejecuta:

docker compose up -d
docker compose ps

La primera vez Docker descargará la imagen. Cuando el contenedor esté en ejecución, abre http://localhost:5678 en el navegador y completa la creación de la cuenta propietaria que muestre n8n. Si todavía no responde, revisa el arranque con docker compose logs --tail 50 n8n.

4. Prueba un flujo sencillo

Crea un workflow y añade Manual Trigger. Conéctalo a Edit Fields (Set). En ese segundo nodo selecciona Manual Mapping, crea un campo de texto llamado mensaje y dale el valor fijo Mi primer flujo funciona.

Ejecuta el flujo manualmente y abre la salida del segundo nodo. Debes encontrar el campo mensaje con ese texto. Guarda el workflow con un nombre que reconozcas. Ya has comprobado el recorrido disparador → transformación → resultado sin depender de una API externa. Los nombres de los botones pueden variar según la versión. Referencia de Edit Fields.

5. Cómo pararlo y volver otro día

En la misma carpeta del proyecto, para detenerlo utiliza:

docker compose stop

Para volver a arrancarlo, abre primero Docker Desktop y ejecuta:

cd "$HOME\n8n-local"
docker compose start

Después vuelve a http://localhost:5678. Los datos persisten en el volumen mientras no lo elimines. Un volumen persistente no sustituye una copia de seguridad: exporta tus workflows y prepara una copia del volumen antes de cambios importantes. Cómo funcionan los volúmenes de Docker.

Problemas frecuentes

No se encuentra el archivo de configuración

Comprueba que estás en la carpeta del proyecto y que el archivo no se llama compose.yaml.txt.

El puerto 5678 ya está ocupado

Puede que ya tengas n8n abierto. Revisa esa instalación antes de iniciar otra. Como alternativa, cambia el puerto de la izquierda a 127.0.0.1:5679:5678, ejecuta docker compose up -d y abre http://localhost:5679.

¿Por qué esta guía no usa npx n8n?

La documentación de n8n indica que las instalaciones basadas en npm están desaconsejadas a partir de n8n 3.0. Si tienes una instalación anterior con Node.js, conserva sus datos y revisa la migración antes de sustituirla.

¿Puedo recibir webhooks externos en localhost?

Un servicio de internet no puede llamar directamente al localhost de tu ordenador. Eso requiere una dirección accesible y una configuración adicional; este tutorial se limita a la práctica local.

Siguiente paso

Prueba a añadir un segundo campo al flujo y observa cómo cambia la salida. Antes de conectar WhatsApp o una herramienta de IA, entender estos datos te ayudará a detectar errores.

Volver a las rutas de aprendizaje de n8nfácil →