Tutorial: n8n con Docker Compose en Linux

Tutorial Completo: Instalar y correr n8n en Linux con Docker Compose

Este tutorial te guiará paso a paso para instalar y ejecutar n8n usando Docker Compose en un sistema Linux (como Ubuntu), con buenas prácticas y configuraciones recomendadas.

---

1. Actualizar el sistema

Es buena práctica empezar actualizando los paquetes y sistema:

sudo apt update
sudo apt upgrade -y

---

2. Instalar dependencias necesarias para Docker

sudo apt install -y ca-certificates curl gnupg lsb-release

---

3. Agregar repositorio oficial de Docker

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update

---

4. Instalar Docker y plugin Docker Compose

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

---

5. Verificar versión Docker y Docker Compose

docker --version
docker compose version

Deberías ver algo así como Docker version 20.x.x y Docker Compose version v2.x.x.

---

6. Agregar tu usuario al grupo docker (para usar Docker sin sudo)

sudo usermod -aG docker $USER

Luego, cerrá sesión y volvé a entrar para aplicar los cambios.

---

7. Verificar que el servicio Docker esté activo y habilitado al inicio

systemctl status docker
systemctl is-enabled docker

Si el servicio no está activo o habilitado, arrancalo con:

sudo systemctl start docker
sudo systemctl enable docker

---

8. Crear carpeta para tu proyecto y archivo docker-compose.yml

Ejemplo de ruta para crear la carpeta y ubicarse:

mkdir -p ~/Documentos/docker/n8n
cd ~/Documentos/docker/n8n

Luego creá el archivo docker-compose.yml con el siguiente contenido (sin la línea version: porque es obsoleta):

services:
  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=hugo
      - N8N_BASIC_AUTH_PASSWORD=tu_password_segura
    volumes:
      - ./n8n_data:/home/node/.n8n
    restart: always

---

9. Levantar n8n con Docker Compose

docker compose up -d

Si da error de permisos, usá sudo o asegurate que tu usuario esté en el grupo docker.

---

10. Acceder a n8n

• Desde la misma máquina: http://localhost:5678
• Desde otra PC en la red local: http://<ip-local>:5678 (para ver la IP local usá ip a)

---

11. Comandos útiles

• Ver contenedores corriendo: docker ps
• Parar y borrar contenedores: docker compose down
• Ver logs en tiempo real: docker compose logs -f

---

12. Backup automático de datos

El directorio ./n8n_data contiene tus workflows, credenciales y datos. Para hacer backups, podés crear un cron job diario:

0 3 * * * tar -czf /home/hugo/backup_n8n_$(date +\%F).tar.gz /home/hugo/Documentos/docker/n8n/n8n_data

---

13. Actualizar n8n

docker compose pull
docker compose up -d

---

14. Consideraciones de seguridad

• Activar autenticación básica (ya incluido en el archivo).
• Evitar exponer n8n directamente a Internet sin VPN o túneles seguros.
• Usar contraseñas seguras.

---

15. Extras y variables útiles

• N8N_EDITOR_BASE_URL: para configurar la URL pública si usás túneles o proxies.
• N8N_PORT: cambiar puerto interno.
• WEBHOOK_TUNNEL_URL: para que n8n genere URLs públicas en webhooks.

---