Skip to content
BotServBotServ
n8nInstalaciónDockerSelf-HostingWorkflow

Instalar n8n

Instala y configura n8n. Docker, Docker Compose, configuración, primeros workflows y solución de problemas.

S

schutzgeist

5 min read
Instalar n8n

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

  1. Haz clic en “New Workflow”.
  2. Arrastra un nodo “Manual Trigger” al flujo de trabajo.
  3. Arrastra un nodo “Set” junto a él.
  4. Conecta ambos nodos.
  5. 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

VariableDescripciónEjemplo
N8N_HOSTHost para n8n0.0.0.0
N8N_PORTPuerto para n8n5678
N8N_PROTOCOLhttp o httpshttp
WEBHOOK_URLURL para webhookshttp://localhost:5678/
GENERIC_TIMEZONEZona horariaEurope/Berlin
TZZona horariaEurope/Berlin
N8N_ENCRYPTION_KEYClave de cifradocadena aleatoria
DB_TYPETipo de base de datossqlite (por defecto)
EXECUTIONS_DATA_PRUNEEliminar ejecuciones antiguastrue
EXECUTIONS_DATA_MAX_AGEEdad máxima en días30

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

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?

n8n es una herramienta de automatización de flujos de trabajo. Construyes flujos de trabajo de forma visual mediante arrastrar y soltar, sin necesidad de programar. n8n es de código abierto y auto-hospedado.

¿Cómo instalo n8n?

La forma más fácil es con Docker: docker run -d -p 5678:5678 n8nio/n8n:latest. O con Docker Compose para configuraciones más complejas.

¿En qué puerto se ejecuta n8n?

Por defecto en el puerto 5678. Puedes cambiar el puerto con -p, por ejemplo -p 8080:5678 para el puerto 8080.

¿Debo usar Docker o Docker Compose?

Para configuraciones simples, Docker es suficiente. Para configuraciones más complejas (n8n + Ollama + base de datos), Docker Compose es mejor porque defines todo en un archivo.

¿Dónde se almacenan los datos?

En un volumen de Docker (n8n_data). El volumen contiene flujos de trabajo, credenciales y configuración. Realiza copias de seguridad regularmente.

¿Cómo conecto n8n con Ollama?

Inicia ambos en la misma red de Docker, luego usa http://ollama:11434 como URL en n8n. Consulta n8n-Ollama-Integration para más detalles.

¿Cómo activo HTTPS?

Establece N8N_PROTOCOL=https y WEBHOOK_URL=https://tu-dominio.de. Usa un proxy inverso (Nginx, Traefik) para certificados TLS.

¿Es n8n seguro?

Sí, si lo aseguras correctamente: contraseña sólida, HTTPS, no exponer a Internet, activar cifrado.

¿Cómo realizo copias de seguridad de n8n?

Realiza copias de seguridad del volumen n8n_data. Contiene todos los flujos de trabajo y credenciales. Exporta regularmente o realiza copias de seguridad del volumen.

n8n no inicia. ¿Qué hago?

Revisa los logs con docker logs n8n. Causas comunes: puerto en uso, memoria insuficiente, corrupción de base de datos.

Fuentes y lecturas adicionales

Volver al blog
Share:

Entradas relacionadas