Instalar n8n
Qué cubre este artículo sobre la instalación de n8n
- Cómo instalar n8n con Docker o Docker Compose.
- Cómo realizar la configuración básica.
- Cómo crear tu primer flujo de trabajo.
- Qué variables de entorno son importantes.
- Solución de problemas comunes.
Introducción: instalar n8n explicado de forma clara
n8n es una herramienta de automatización de flujos de trabajo que conecta procesos de forma visual. La instalas en tu servidor, la abres en el navegador y construyes flujos de trabajo mediante arrastrar y soltar. n8n es de código abierto, auto-hospedado y cuenta con más de 400 integraciones.
Este artículo está dirigido a usuarios que desean instalar n8n. Deberías tener conocimientos básicos de Docker. Encontrarás los fundamentos en Docker Fundamentos.
¿Por qué necesito n8n?
Imagina que quieres automatizar tareas repetitivas: procesar correos electrónicos, sincronizar bases de datos, generar informes. En lugar de escribir scripts, construyes flujos de trabajo de forma visual. n8n hace que la automatización sea accesible sin necesidad de programar.
Instalar n8n en resumen
n8n es una herramienta de flujo de trabajo auto-hospedada. La instalas con Docker, la abres en el navegador y creas flujos de trabajo mediante arrastrar y soltar. Para flujos de trabajo con IA, conectas n8n con Ollama.
La idea central es: flujos de trabajo visuales en lugar de scripts.
¿Para quién es este artículo?
- Auto-hospedadores que desean instalar n8n.
- Automatizadores que quieren construir flujos de trabajo.
- Desarrolladores que buscan introducir automatización.
- Equipos que necesitan automatizar tareas repetitivas.
Los conocimientos previos en Docker son útiles.
Términos importantes
- n8n - Automatización de flujos de trabajo. Cuándo es útil: la herramienta en sí.
- Docker - Plataforma de contenedores. Cuándo es útil: para la instalación.
- Docker Compose - Herramienta multi-contenedor. Cuándo es útil: para configuraciones complejas.
- Workflow - Secuencia de pasos. Cuándo es útil: lo que n8n automatiza.
- Node - Componente del flujo de trabajo. Cuándo es útil: los pasos individuales.
- Ollama - Servidor de modelos local. Cuándo es útil: para flujos de trabajo con IA.
Requisitos previos
- Docker instalado. Consulta Docker Fundamentos.
- Docker Compose instalado.
- Mínimo 1 GB de RAM, 1 núcleo de CPU.
- Puerto 5678 disponible (por defecto).
Instalación con Docker Compose
1. Crear docker-compose.yml
version: "3.8"
services:
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_HOST=0.0.0.0
- N8N_PORT=5678
- N8N_PROTOCOL=http
- WEBHOOK_URL=http://localhost:5678/
- GENERIC_TIMEZONE=Europe/Berlin
- TZ=Europe/Berlin
volumes:
- n8n_data:/home/node/.n8n
networks:
- n8n-network
volumes:
n8n_data:
networks:
n8n-network:
driver: bridge
2. Iniciar
docker compose up -d
3. Abrir
Abre el navegador: http://localhost:5678
Instalación con Docker (sin Compose)
docker run -d \
--name n8n \
-p 5678:5678 \
-e N8N_HOST=0.0.0.0 \
-e N8N_PORT=5678 \
-e WEBHOOK_URL=http://localhost:5678/ \
-e GENERIC_TIMEZONE=Europe/Berlin \
-e TZ=Europe/Berlin \
-v n8n_data:/home/node/.n8n \
--restart unless-stopped \
n8nio/n8n:latest
Primeros pasos
1. Crear cuenta de administrador
En el primer inicio se te pedirá que crees una cuenta de administrador.
2. Crear el primer flujo de trabajo
- Haz clic en “New Workflow”.
- Arrastra un nodo “Manual Trigger” al flujo de trabajo.
- Arrastra un nodo “Set” junto a él.
- Conecta ambos nodos.
- Haz clic en “Execute Workflow”.
3. Guardar el flujo de trabajo
Haz clic en “Save” e ingresa un nombre para el flujo de trabajo.
Variables de entorno importantes
| Variable | Descripción | Ejemplo |
|---|---|---|
| N8N_HOST | Host para n8n | 0.0.0.0 |
| N8N_PORT | Puerto para n8n | 5678 |
| N8N_PROTOCOL | http o https | http |
| WEBHOOK_URL | URL para webhooks | http://localhost:5678/ |
| GENERIC_TIMEZONE | Zona horaria | Europe/Berlin |
| TZ | Zona horaria | Europe/Berlin |
| N8N_ENCRYPTION_KEY | Clave de cifrado | cadena aleatoria |
| DB_TYPE | Tipo de base de datos | sqlite (por defecto) |
| EXECUTIONS_DATA_PRUNE | Eliminar ejecuciones antiguas | true |
| EXECUTIONS_DATA_MAX_AGE | Edad máxima en días | 30 |
Conectar con Ollama
Si deseas conectar n8n con Ollama, ambos deben estar en la misma red:
version: "3.8"
services:
ollama:
image: ollama/ollama:latest
container_name: ollama
restart: unless-stopped
ports:
- "11434:11434"
volumes:
- ollama_data:/root/.ollama
networks:
- n8n-network
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_HOST=0.0.0.0
- WEBHOOK_URL=http://localhost:5678/
volumes:
- n8n_data:/home/node/.n8n
networks:
- n8n-network
volumes:
ollama_data:
n8n_data:
networks:
n8n-network:
driver: bridge
En n8n usas entonces http://ollama:11434 como URL de Ollama.
Consulta n8n-Ollama-Integration para más detalles.
Notas de seguridad
- Establecer contraseña: Crea una contraseña de administrador sólida.
- Usar HTTPS: Para producción, activa HTTPS. Consulta Certificados TLS.
- No exponer: No expongas n8n a Internet sin autenticación.
- Cifrado: Establece N8N_ENCRYPTION_KEY para datos sensibles.
- Copias de seguridad: Realiza copias de seguridad de los datos de n8n regularmente. Consulta Backup.
Solución de problemas
n8n no inicia
# Revisar logs
docker logs n8n
# Causas comunes:
# - Puerto 5678 en uso
# - Memoria insuficiente
# - Corrupción de base de datos
Puerto ya en uso
# Usar otro puerto
docker run -d -p 5679:5678 n8nio/n8n:latest
Problema de base de datos
# Reiniciar base de datos
docker exec -it n8n n8n db:reset
Ollama no es accesible
# Verifica si Ollama está en ejecución
docker ps | grep ollama
# Verifica la red
docker network inspect n8n-network
Ejemplo práctico: Primer flujo de trabajo
// Flujo de trabajo: Crear una entrada de registro cada hora
// 1. Schedule Trigger: Cada hora
// 2. Function Node:
return {
timestamp: new Date().toISOString(),
message: "Verificación horaria"
};
// 3. HTTP Request: Enviar a Ollama (opcional)
Enlaces relacionados
- n8n Guide - n8n en detalle.
- n8n-Ollama-Integration - Ollama en n8n.
- Docker Fundamentos - Entender Docker.
- Docker Compose - Entender Compose.
- Workflow-Automatisierung - Fundamentos.
- Instalar Ollama - Instalar Ollama.
Puntos clave:
- n8n es una herramienta de flujo de trabajo auto-hospedada.
- Instalación con Docker o Docker Compose.
- Puerto 5678, cuenta de administrador al primer inicio.
- Para flujos de trabajo con IA, conéctalo con Ollama.
- Seguridad: contraseña, HTTPS, no exponer.
FAQ
¿Qué es n8n?
¿Cómo instalo n8n?
¿En qué puerto se ejecuta n8n?
¿Debo usar Docker o Docker Compose?
¿Dónde se almacenan los datos?
¿Cómo conecto n8n con Ollama?
¿Cómo activo HTTPS?
¿Es n8n seguro?
¿Cómo realizo copias de seguridad de n8n?
n8n no inicia. ¿Qué hago?
Fuentes y lecturas adicionales
- n8n Documentación - Documentación oficial.
- n8n Docker - Instalación con Docker.
- Docker Compose - Documentación de Compose.


