Instalación de n8n Local

¿Por qué instalar n8n localmente?

Control total sobre tus datos
Sin límites de ejecuciones
Personalización completa
Ideal para desarrollo y testing
Gratis para siempre

Tutorial Completo de Instalación

Requisitos del Sistema

Especificaciones Mínimas

CPU

2 cores mínimo

Recomendado: 4 cores

RAM

4 GB mínimo

Recomendado: 8 GB

Almacenamiento

10 GB disponible

Para datos y logs

Sistema Operativo

Windows 10+, macOS, Linux

64-bit requerido

Software Requerido:

Software	Versión	Requerido para	Enlace
Node.js	16.9 o superior	Instalación con NPM	Descargar
Docker Desktop	Última versión	Instalación con Docker	Descargar
Git	Cualquier versión	Opcional (recomendado)	Descargar

Opción 1: Instalación con Docker (Recomendado)

Instalación Rápida con Docker

Verificar Docker

Asegúrate de que Docker esté instalado y funcionando:

docker --version

Deberías ver algo como: Docker version 20.10.x

Crear carpeta para datos

n8n necesita persistir datos entre reinicios:

# Windows PowerShell
mkdir $HOME\.n8n

# macOS/Linux
mkdir ~/.n8n

Ejecutar n8n con Docker

Comando completo para iniciar n8n:

# Windows PowerShell
docker run -it --rm `
  --name n8n `
  -p 5678:5678 `
  -e N8N_BASIC_AUTH_ACTIVE=true `
  -e N8N_BASIC_AUTH_USER=admin `
  -e N8N_BASIC_AUTH_PASSWORD=password `
  -v ${HOME}/.n8n:/home/node/.n8n `
  n8nio/n8n

# macOS/Linux
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=password \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Acceder a n8n

Abre tu navegador y ve a:

URL: http://localhost:5678

Usuario: admin

Contraseña: password

Docker Compose (Producción)

Para un setup más robusto, crea un archivo docker-compose.yml:

version: "3"

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=changeme123
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://localhost:5678/
      - GENERIC_TIMEZONE=America/Mexico_City
    volumes:
      - n8n_data:/home/node/.n8n
      
volumes:
  n8n_data:

Luego ejecuta:

docker-compose up -d

Opción 2: Instalación con NPM

Instalación con Node.js

Verificar Node.js

node --version
npm --version

Necesitas Node.js 16.9 o superior

Instalar n8n globalmente

npm install n8n -g

Esto puede tomar varios minutos

Iniciar n8n

# Inicio básico
n8n

# Con autenticación
n8n start --tunnel

Consideraciones NPM

SQLite como base de datos por defecto
Para producción, considera usar PostgreSQL
Los datos se guardan en ~/.n8n
Actualiza regularmente con npm update -g n8n

Configuración Inicial

Primeros Pasos

1. Crear Usuario

En el primer acceso, crea tu usuario administrador

2. Configurar SMTP

Para notificaciones por email (opcional)

3. Timezone

Ajusta tu zona horaria en Settings

Variables de Entorno Importantes:

Variable	Descripción	Ejemplo
`N8N_HOST`	Hostname de n8n	localhost
`N8N_PORT`	Puerto de escucha	5678
`N8N_PROTOCOL`	HTTP o HTTPS	https
`WEBHOOK_URL`	URL para webhooks	https://n8n.tudominio.com/
`N8N_ENCRYPTION_KEY`	Clave para encriptar credenciales	Genera una aleatoria

Configuración Avanzada

Solución de Problemas Comunes

Problemas Frecuentes

❌ Puerto 5678 en uso

Síntoma: Error "bind: address already in use"

Solución:

# Ver qué usa el puerto
netstat -ano | findstr :5678

# Cambiar puerto en Docker
docker run -p 5679:5678 ...

# Cambiar puerto con NPM
n8n start --port=5679

❌ Permisos en Windows

Síntoma: Error al crear volúmenes Docker

Solución:

Ejecutar Docker Desktop como administrador
Verificar que tu usuario tenga permisos en la carpeta
Usar rutas absolutas en Windows

❌ n8n no arranca

Síntoma: Se cierra inmediatamente

Solución:

# Ver logs detallados
docker logs n8n

# Ejecutar en modo debug
export N8N_LOG_LEVEL=debug
n8n start

Verificación Final

Si todo está correcto, deberías poder:

Acceder a n8n en http://localhost:5678
Iniciar sesión con tus credenciales
Crear tu primer workflow
Ejecutar un workflow de prueba

Siguientes Pasos

Guía Completa n8n

Aprende a usar n8n

Docker Básico

Fundamentos de Docker

Primer Proyecto

Crea tu primera automatización

Siguiente: Docker Básico