Instal·lació de n8n amb Docker

Requisits previs

Abans de continuar, assegura't que tens instal·lat:

Docker Desktop (Windows/Mac) o Docker Engine (Linux)
Docker Compose (inclòs a Docker Desktop)
Mínim 2 GB de RAM disponibles per a n8n

Comprova que Docker funciona:

docker --version
docker compose version

Opció 1: Comanda ràpida (sense persistència)

Per a proves ràpides, pots executar n8n amb una sola comanda:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  docker.n8n.io/n8nio/n8n

Obre el navegador a http://localhost:5678 i ja tens n8n funcionant.

Dades no persistents

Amb aquesta comanda, quan aturis el contenidor perdràs tots els workflows que hagis creat. Usa docker-compose per a persistència.

Opció 2: Docker Compose (recomanada)

1. Crear l'estructura de directoris

mkdir -p ~/n8n/data
cd ~/n8n

2. Crear el fitxer docker-compose.yml

Crea el fitxer docker-compose.yml amb aquest contingut:

version: '3.8'

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://localhost:5678/
      - GENERIC_TIMEZONE=Europe/Madrid
      - N8N_ENCRYPTION_KEY=canvia-aquesta-clau-aleatoria-32chars
    volumes:
      - ./data:/home/node/.n8n
    user: "1000:1000"

Clau de xifrat

Canvia el valor de N8N_ENCRYPTION_KEY per una cadena aleatoria de 32 caràcters. Aquesta clau xifra les teves credencials. Si la perds o la canvies, les credencials guardades quedaran inutilitzables.

3. Crear el directori de dades amb els permisos correctes

# Linux/Mac
mkdir -p data
sudo chown -R 1000:1000 data

# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path data

4. Iniciar n8n

docker compose up -d

5. Verificar que funciona

# Comprovar que el contenidor esta en execucio
docker compose ps

# Veure els logs
docker compose logs -f n8n

Obre el navegador a http://localhost:5678.

Configurar el compte d'usuari

La primera vegada que accedeixes a n8n, et demanar crear un compte d'administrador:

Introdueix el teu nom
Introdueix un correu electrònic
Crea una contrasenya segura
Fes clic a Set up account

Compte local

Aquest compte es només per a n8n local. No està connectat a cap compte de n8n.io cloud.

Actualitzar n8n

Per actualitzar a la darrera versió:

# Baixar la nova imatge
docker compose pull

# Reiniciar el servei
docker compose up -d

Aturar i reiniciar

# Aturar
docker compose down

# Reiniciar
docker compose restart n8n

# Veure l'estat
docker compose ps

Estructura de fitxers

Després de l'execució, el directori data/ contindra:

data/
├── .n8n/
│   ├── config               # Configuracio de n8n
│   ├── database.sqlite      # Base de dades (workflows, execucions)
│   └── nodes/               # Nodes personalitzats (si n'hi ha)

Miniactivitat ACN8N5

Instal·la n8n amb docker-compose, crea el compte d'administrador i verifica que pots accedir a la interfície. Fes una captura de pantalla de la pantalla principal de n8n un cop configurat.