Guia: Instalacion de n8n en tu ordenador

Cual metodo elegir?

Principiantes

Si nunca has usado la terminal o no sabes que es npm, sigue la Opcion 1.

Ir a Opcion 1

Desarrolladores

Si ya tienes Node.js instalado y sabes usar npm, ve directo a la Opcion 2.

Ir a Opcion 2

DevOps / Avanzados

Si prefieres contenedores y tienes Docker instalado, usa la Opcion 3.

Ir a Opcion 3

Que es n8n?

n8n (pronunciado "n-eight-n") es una herramienta de automatizacion de flujos de trabajo. Te permite conectar diferentes aplicaciones y servicios para que trabajen juntos automaticamente.

Ejemplo: Puedes crear un flujo que cuando recibas un email con un archivo adjunto, automaticamente lo suba a Google Drive y te envie una notificacion a Slack.

Opcion 1: Instalacion para Principiantes

Para quien es esto? Para personas que nunca han usado la terminal, no saben que es npm, o simplemente quieren seguir pasos sencillos sin complicarse.

Paso 1: Instalar Node.js

Que es Node.js?

Node.js es un programa que permite ejecutar n8n. Solo tienes que instalarlo una vez.

1.1 Descargar Node.js

Ve a https://nodejs.org/
Haz clic en el boton verde que dice "LTS" (es la version recomendada)
Se descargara un archivo .msi

1.2 Instalar Node.js

Abre el archivo descargado
Haz clic en "Next" (Siguiente)
Acepta los terminos -> "Next"
Deja la ruta por defecto -> "Next"
Deja las opciones por defecto -> "Next"
IMPORTANTE: Marca la casilla que dice "Automatically install the necessary tools..." si aparece
Haz clic en "Install"
Espera a que termine y haz clic en "Finish"

1.3 Verificar que se instalo bien

Abre el menu de inicio de Windows
Escribe "cmd" y abre "Simbolo del sistema"
Escribe esto y presiona Enter:

node --version

Deberia aparecer algo como: v20.x.x o v22.x.x

Si aparece un error: Cierra la terminal, reinicia el ordenador e intentalo de nuevo.

Paso 2: Instalar n8n

2.1 Abrir la terminal

Abre el menu de inicio
Escribe "PowerShell"
Haz clic derecho en "Windows PowerShell" y selecciona "Ejecutar como administrador"
Si te pregunta si quieres permitir cambios, haz clic en "Si"

2.2 Instalar n8n globalmente

Copia y pega este comando en la terminal y presiona Enter:

npm install -g n8n

Espera a que termine (puede tardar 1-3 minutos).

Que significa esto?

npm = El gestor de paquetes de Node.js
install = Instalar algo
-g = Globalmente (disponible en todo el sistema)
n8n = El nombre del programa a instalar

2.3 Verificar la instalacion

Escribe este comando y presiona Enter:

n8n --version

Deberia aparecer algo como: 1.x.x

Felicidades! Ya tienes n8n instalado. Ve a la seccion "Como ejecutar n8n" para aprender a usarlo.

Opcion 2: Instalacion con npm

Requisito: Node.js version 20.19 a 24.x. Si no lo tienes, sigue el Paso 1 de la Opcion 1.

Verificar requisitos

Comprobar versiones

node --version
npm --version

Necesitas: Node.js v20.19+ (hasta v24.x)

Opciones de instalacion

Probar sin instalar (npx)

Ideal para probar n8n rapidamente:

npx n8n

Nota: Los datos se pierden al cerrar la terminal.

Instalacion global (recomendada)

npm install n8n -g

Luego ejecuta:

n8n start

Instalar version especifica

npm install -g n8n@2.3.4

Version beta (inestable):

npm install -g n8n@next

Configurar zona horaria (Espana)

Para que los nodos programados funcionen correctamente:

PowerShell (temporal)

$env:GENERIC_TIMEZONE="Europe/Madrid"
$env:TZ="Europe/Madrid"
n8n start

CMD (temporal)

set GENERIC_TIMEZONE=Europe/Madrid
set TZ=Europe/Madrid
n8n start

Hacer permanente (PowerShell como Administrador)

[System.Environment]::SetEnvironmentVariable("GENERIC_TIMEZONE", "Europe/Madrid", "User")
[System.Environment]::SetEnvironmentVariable("TZ", "Europe/Madrid", "User")

Crear script de inicio (Windows)

Archivo iniciar-n8n.bat

Crea un archivo iniciar-n8n.bat en tu escritorio:

@echo off
set GENERIC_TIMEZONE=Europe/Madrid
set TZ=Europe/Madrid
n8n start
pause

Doble clic para iniciar n8n con la zona horaria correcta.

Ubicacion de datos

Por defecto, n8n guarda los datos en:

C:\Users\TU_USUARIO\.n8n\

Esta carpeta contiene:

database.sqlite - Base de datos con workflows y credenciales
config - Configuracion
Claves de encriptacion

Los datos persisten aunque:

Cierres la terminal
Reinicies el ordenador
Actualices n8n

Comandos utiles

Iniciar n8n

n8n start

Iniciar con tunnel (webhooks)

n8n start --tunnel

Solo para desarrollo local

Actualizar a ultima version

npm update -g n8n

Ver version instalada

n8n --version

Revertir a version anterior

# Instalar version especifica anterior
npm install -g n8n@2.2.0

# Si hubo migracion de base de datos, revertirla
n8n db:revert

Migracion y backup

Copia de seguridad

Copia la carpeta completa:

C:\Users\TU_USUARIO\.n8n\

Guardala en un lugar seguro.

Migrar a otro ordenador

Copia la carpeta .n8n al nuevo PC
Instala Node.js y n8n
Ejecuta n8n start

Listo! n8n estara disponible en: http://localhost:5678

Opcion 3: Instalacion con Docker

Requisito: Debes tener Docker Desktop instalado y funcionando. Descargalo desde docker.com

Verificar Docker

Comprobar instalacion

docker --version

Estructura de archivos recomendada

Crear carpeta para n8n

Crea una carpeta donde guardaras toda la configuracion:

C:\Users\TU_USUARIO\n8n-docker\
├── docker-compose.yml    # Configuracion de Docker
└── n8n-data\             # Datos persistentes (se crea automaticamente)

Configuracion con Docker Compose (recomendado)

Archivo docker-compose.yml

Crea el archivo docker-compose.yml con esta configuracion:

version: '3.8'

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=Europe/Madrid
      - TZ=Europe/Madrid
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_RUNNERS_ENABLED=true
      - N8N_ENCRYPTION_KEY=tu-clave-secreta-aqui
    volumes:
      - ./n8n-data:/home/node/.n8n
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost:5678/healthz"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 30s

volumes:
  n8n-data:

Explicacion de la configuracion

image: docker.n8n.io/n8nio/n8n:latest - Imagen oficial de n8n
restart: unless-stopped - Se reinicia automaticamente excepto si lo paras manualmente
GENERIC_TIMEZONE - Zona horaria para nodos programados (Schedule Trigger, etc.)
N8N_RUNNERS_ENABLED - Habilita task runners (recomendado)
N8N_ENCRYPTION_KEY - Clave para cifrar credenciales (MUY IMPORTANTE guardarla)
volumes: ./n8n-data - Carpeta local donde se guardan todos los datos
healthcheck - Verifica que n8n este funcionando correctamente

IMPORTANTE: La clave N8N_ENCRYPTION_KEY es necesaria para descifrar tus credenciales. Si la pierdes, perderas acceso a las credenciales guardadas. Guardala en un lugar seguro!

Comandos utiles

Iniciar n8n

cd C:\Users\TU_USUARIO\n8n-docker
docker compose up -d

Parar n8n

cd C:\Users\TU_USUARIO\n8n-docker
docker compose down

Ver logs en tiempo real

cd C:\Users\TU_USUARIO\n8n-docker
docker compose logs -f

Ver estado del contenedor

docker ps --filter "name=n8n"

Actualizar a la ultima version

cd C:\Users\TU_USUARIO\n8n-docker
docker compose pull
docker compose down
docker compose up -d

Persistencia de datos

Todos los datos se guardan en la carpeta n8n-data:

Workflows
Credenciales (cifradas)
Historial de ejecuciones
Configuracion de usuario

Los datos persisten aunque:

Apagues Docker Desktop
Reinicies el ordenador
Elimines el contenedor
Actualices n8n

Migracion y backup

Copia de seguridad

Simplemente copia la carpeta completa n8n-docker que incluye:

docker-compose.yml (con la clave de encriptacion)
n8n-data/ (todos tus datos)

Migrar a otro ordenador

Copia la carpeta n8n-docker al nuevo PC
Instala Docker Desktop
Ejecuta docker compose up -d

Perfecto! n8n estara disponible en: http://localhost:5678

Como ejecutar n8n

Iniciar n8n

Si instalaste con npm

n8n

O con npx:

npx n8n

Si instalaste con Docker

docker start n8n

O con Docker Compose:

docker-compose up -d

Acceder a n8n

Abrir en el navegador

Abre tu navegador (Chrome, Firefox, Edge...)
Ve a: http://localhost:5678
La primera vez te pedira crear una cuenta (es local, solo en tu ordenador)

Detener n8n

Para parar n8n

Si usas npm: Presiona Ctrl + C en la terminal
Si usas Docker: docker stop n8n
Si usas Docker Compose: docker-compose down

Problemas comunes

"npm no se reconoce como comando"

Solucion: Node.js no esta instalado correctamente o no se anadio al PATH.

Reinicia el ordenador
Si persiste, reinstala Node.js marcando la opcion "Add to PATH"

"Error de permisos" al instalar con npm

Solucion: Ejecuta la terminal como administrador:

Cierra la terminal actual
Busca "PowerShell" o "cmd"
Haz clic derecho -> "Ejecutar como administrador"
Intenta el comando de nuevo

"El puerto 5678 esta en uso"

Solucion: Usa otro puerto:

n8n --port 5679

O con Docker:

docker run -it --rm --name n8n -p 5679:5678 n8nio/n8n

"Docker daemon is not running"

Solucion: Inicia Docker Desktop:

Busca "Docker Desktop" en el menu de inicio
Abrelo y espera a que inicie (icono verde)
Intenta el comando de nuevo

Guia: Instalacion de n8n

Cual metodo elegir?

Contenido

Que es n8n?

Opcion 1: Instalacion para Principiantes

Paso 1: Instalar Node.js

Paso 2: Instalar n8n

Opcion 2: Instalacion con npm

Verificar requisitos

Opciones de instalacion

Configurar zona horaria (Espana)

Crear script de inicio (Windows)

Ubicacion de datos

Comandos utiles

Migracion y backup

Opcion 3: Instalacion con Docker

Verificar Docker

Estructura de archivos recomendada

Configuracion con Docker Compose (recomendado)

Comandos utiles

Persistencia de datos

Migracion y backup

Como ejecutar n8n

Iniciar n8n

Acceder a n8n

Detener n8n

Problemas comunes