Instalar n8n en local con Docker Desktop: guía completa de configuración

Si te ha picado la curiosidad por la automatización de flujos de trabajo pero herramientas como Zapier o Make te parecen demasiado caras o limitadas, n8n merece que le eches un vistazo serio.

n8n es una herramienta de automatización de flujos de trabajo de código abierto: conectas servicios de forma visual enlazando nodos de "disparador" con nodos de "acción". Cuando algo ocurre en una aplicación, n8n ejecuta automáticamente una acción en otra. Sin necesidad de programar en la mayoría de los casos.

¿Lo mejor? Puedes alojarlo tú mismo. Ejecútalo en tu propia máquina o servidor, sin pagar nada por el software, y sin límites en la cantidad de automatizaciones que ejecutas.

Esta guía te lleva paso a paso por la instalación de n8n en tu PC local usando Docker Desktop — con comandos que puedes copiar y pegar directamente.

¿Qué puedes hacer con n8n?

Antes de meternos en la instalación, aquí tienes una idea rápida de lo que n8n puede automatizar:

Cuando llega un nuevo correo a Gmail con una etiqueta específica, añadir una fila en Google Sheets
Cuando se envía un formulario, mandar una notificación a Slack y crear una página en Notion
Cada mañana a las 9, obtener el clima del día y enviarlo por LINE o Telegram
Cuando se fusiona un PR en GitHub, marcar la tarea correspondiente como completada en tu gestor de proyectos
Conectar con cualquier API REST, incluso las internas personalizadas

n8n tiene más de 400 integraciones prediseñadas. Cada una es un nodo que arrastras al lienzo y configuras con un formulario — sin código para los casos de uso estándar.

¿Por qué alojar tú mismo en vez de usar Make o Zapier?

Las herramientas en la nube cobran por ejecución. Si ejecutas 10.000 automatizaciones al mes, pagas por eso. Con una instancia de n8n autoalojada en tu máquina local (o un VPS barato), el coste del software es cero y tú eres dueño de tus datos.

Requisitos previos

Windows: verificar que la virtualización está activada

Docker requiere virtualización de CPU. Comprueba si está activada:

Pulsa Ctrl + Shift + Esc para abrir el Administrador de tareas
Haz clic en la pestaña Rendimiento
Selecciona CPU
Busca Virtualización: Habilitado en la parte inferior derecha

Si dice Deshabilitado, necesitarás activarlo en la BIOS/UEFI. Reinicia y pulsa Delete o F2 (varía según el fabricante) durante el arranque. Busca configuraciones llamadas "Virtualization Technology", "VT-x" o "SVM" y actívalas.

Mac

Docker Desktop funciona tanto en Mac con Intel como con Apple Silicon (M1/M2/M3). No necesitas configuración adicional.

Lo que necesitarás

Acceso de administrador/sudo en tu máquina
Una conexión a internet estable (Docker descargará unos cuantos cientos de MB)

Paso 1: Instalar Docker Desktop

n8n se distribuye como una imagen de Docker. Docker Desktop es el software que ejecuta contenedores Docker en tu máquina.

Descarga Docker Desktop desde docker.com/products/docker-desktop — elige la versión correcta para tu sistema operativo.

Instalación en Windows

Ejecuta el instalador .exe descargado
Cuando se te pregunte, mantén marcada la opción "Use WSL 2 instead of Hyper-V" (WSL 2 es la opción preferida)
Sigue las indicaciones en pantalla y haz clic en OK
Reinicia tu PC cuando se te pida

Instalación en Mac

Abre el archivo .dmg descargado
Arrastra Docker a la carpeta Aplicaciones
Inicia Docker desde Aplicaciones
Aprueba el aviso de permisos con tu contraseña

Verificar la instalación

Después de que Docker Desktop se inicie, la barra de estado en la esquina inferior izquierda debería mostrar "Engine running" con un indicador verde.

Confirma en la terminal:

bash

docker --version

Deberías ver algo como Docker version 27.x.x, build ...

Paso 2: Crear un directorio de datos

Por defecto, los contenedores Docker pierden sus datos cuando se eliminan. Para mantener tus flujos de trabajo, credenciales y configuraciones de n8n a salvo, vamos a mapear una carpeta local de tu máquina al directorio de datos de n8n dentro del contenedor.

En Windows (PowerShell):

powershell

mkdir C:\n8n_data

En Mac / Linux:

bash

mkdir -p ~/.n8n

Solo necesitas hacer esto una vez. Todos los datos de n8n se guardarán aquí, sobreviviendo a reinicios y actualizaciones del contenedor.

Paso 3: Iniciar n8n

Abre una terminal y ejecuta el comando correspondiente a tu sistema operativo.

Windows (PowerShell):

powershell

docker run -d `
  --name n8n `
  -p 5678:5678 `
  --restart unless-stopped `
  -v C:\n8n_data:/home/node/.n8n `
  -e GENERIC_TIMEZONE="Asia/Tokyo" `
  -e TZ="Asia/Tokyo" `
  n8nio/n8n

Mac / Linux:

bash

docker run -d \
  --name n8n \
  -p 5678:5678 \
  --restart unless-stopped \
  -v ~/.n8n:/home/node/.n8n \
  -e GENERIC_TIMEZONE="Asia/Tokyo" \
  -e TZ="Asia/Tokyo" \
  n8nio/n8n

Cambia los valores de zona horaria si no estás en Tokio (Asia/Tokyo → tu zona horaria, por ejemplo America/New_York, Europe/Madrid).

Qué hace cada opción:

Opción	Propósito
`-d`	Ejecutar en modo desacoplado (en segundo plano)
`--name n8n`	Nombrar el contenedor "n8n" para referencia fácil
`-p 5678:5678`	Mapear el puerto 5678 de tu máquina al puerto de n8n
`--restart unless-stopped`	Iniciar n8n automáticamente cuando tu PC se reinicie
`-v ~/.n8n:/home/node/.n8n`	Montar tu carpeta local de datos en el contenedor
`-e GENERIC_TIMEZONE`	Configurar la zona horaria interna de n8n

La primera ejecución descargará la imagen Docker de n8n — esto tarda unos minutos dependiendo de la velocidad de tu conexión. Cuando el comando termine y muestre una cadena hexadecimal larga (el ID del contenedor), n8n estará funcionando.

Verifica que está activo:

bash

docker ps

Deberías ver una fila con el nombre "n8n" y estado "Up".

Paso 4: Primer inicio y configuración de cuenta

Abre tu navegador y ve a:

text

http://localhost:5678

Verás la pantalla de configuración inicial de n8n. Completa:

Tu dirección de correo electrónico
Una contraseña

Esto crea una cuenta local para tu instancia de n8n. Haz clic en Get started y llegarás al panel de control de n8n.

Crear tu primer flujo de trabajo

Una vez dentro, así es como puedes crear un flujo de trabajo de prueba sencillo para familiarizarte con n8n:

Haz clic en + New workflow en el panel de control
Haz clic en el botón + en el lienzo para añadir un nodo
Busca y selecciona Schedule Trigger (se ejecuta en un intervalo de tiempo)
Configura el intervalo — para pruebas, ponlo cada minuto
Haz clic en el + después del trigger de Schedule para añadir otro nodo
Busca Code y selecciónalo
En el nodo Code, escribe:

javascript

return [{ json: { message: "n8n is working!", time: new Date().toISOString() } }];

Haz clic en Execute node para probarlo — deberías ver el resultado inmediatamente
Haz clic en Save para guardar el flujo de trabajo
Activa el interruptor Active — n8n ahora ejecutará esto según tu programación

Enhorabuena — tu primer flujo de trabajo de n8n está funcionando.

Comandos esenciales de gestión del contenedor

bash

# Detener n8n
docker stop n8n

# Iniciar n8n (después de detenerlo manualmente)
docker start n8n

# Reiniciar n8n
docker restart n8n

# Ver logs
docker logs n8n

# Seguir logs en tiempo real
docker logs -f n8n

# Comprobar la versión de n8n
docker exec n8n n8n --version

Actualizar n8n

Cuando se publique una nueva versión de n8n, actualiza así:

bash

# Descargar la imagen más reciente
docker pull n8nio/n8n

# Detener y eliminar el contenedor antiguo (tus datos están a salvo — están en tu carpeta local)
docker stop n8n
docker rm n8n

# Iniciar un nuevo contenedor con la imagen más reciente (mismo comando del Paso 3)
docker run -d \
  --name n8n \
  -p 5678:5678 \
  --restart unless-stopped \
  -v ~/.n8n:/home/node/.n8n \
  -e GENERIC_TIMEZONE="Asia/Tokyo" \
  -e TZ="Asia/Tokyo" \
  n8nio/n8n

Tus flujos de trabajo y credenciales se almacenan en ~/.n8n (o C:\n8n_data en Windows), no en el contenedor. Eliminar y recrear el contenedor no afecta a tus datos.

Limitaciones de ejecutar en local

Ejecutar n8n en tu portátil o escritorio tiene una limitación importante: cuando tu máquina está apagada o en reposo, n8n deja de funcionar.

Esto está bien para desarrollo y pruebas. Pero si quieres que las automatizaciones se ejecuten mientras no estás frente a tu escritorio — tareas nocturnas, informes programados, webhooks de servicios externos — necesitarás un servidor que esté siempre encendido.

El siguiente paso práctico es un VPS (Servidor Privado Virtual). Por unos 5-10 $/mes, tienes un servidor funcionando 24/7 en un centro de datos. Ejecutarías exactamente los mismos comandos de Docker en ese servidor, y tu instancia de n8n sería accesible desde cualquier lugar.

Opciones populares: DigitalOcean, Linode (Akamai), Vultr, o proveedores locales como ConoHa VPS y Sakura VPS. Una instancia de 1 núcleo / 1 GB de RAM es suficiente para ejecutar n8n con cargas de automatización típicas.

Una guía completa sobre cómo desplegar n8n en un VPS está en la hoja de ruta.

Conclusión

Instalar n8n en local con Docker se resume en cuatro pasos:

Instalar Docker Desktop y verificar que está funcionando
Crear una carpeta local de datos (~/.n8n o C:\n8n_data)
Ejecutar el comando docker run para iniciar n8n
Abrir http://localhost:5678 y completar la configuración inicial

A partir de ahí, el lienzo de n8n te espera. Empieza con algo pequeño — automatizar una tarea de copiar y pegar que haces cada semana — y enseguida empezarás a ver dónde más se acumula el ahorro de tiempo.

Una vez que hayas validado tus automatizaciones en local y quieras que funcionen 24/7, pasar a un VPS es el siguiente paso natural.