n8n lokal auf dem Mac installieren – Schritt für Schritt

Voraussetzungen

• macOS (Intel oder Apple Silicon)
• Docker Desktop installiert & gestartet
• Terminal (z. B. iTerm2 oder Apple Terminal)

Installation & Start (lokal)

mkdir -p ~/n8n && cd ~/n8n

services:
  n8n:
    image: n8nio/n8n:latest
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    restart: unless-stopped
volumes:
  n8n_data:

docker compose up -d && docker compose ps

Absicherung (Basic‑Auth & ENCRYPTION_KEY)

Empfohlen für jede produktive Nutzung – auch lokal. Der N8N_ENCRYPTION_KEY schützt gespeicherte Zugangsdaten in n8n.

1. 3.1 Sicheren Schlüssel erzeugen

   TerminalKopieren

   KEY=$(openssl rand -hex 32); echo "N8N_ENCRYPTION_KEY=$KEY"

2. 3.2 Basic‑Auth definieren

   Beispiel‑VariablenKopieren

   export N8N_USER=leo; export N8N_PASS=SuperSicher!2025

3. 3.3 compose erweitern

   Umgebungsvariablen hinzufügen (ersetze die Platzhalter durch deine Werte):

   docker-compose.yml (Ausschnitt)Kopieren

   environment:
     - N8N_BASIC_AUTH_ACTIVE=true
     - N8N_BASIC_AUTH_USER=${N8N_USER}
     - N8N_BASIC_AUTH_PASSWORD=${N8N_PASS}
     - N8N_ENCRYPTION_KEY=${KEY}

   Neu startenKopieren

   docker compose down && docker compose up -d

   Wenn ein vorhandenes config‑File in ~/.n8n einen anderen Schlüssel enthält, stoppt n8n mit „Mismatching encryption keys“. Lösung: config sichern/entfernen oder den alten Schlüssel wiederverwenden (siehe Troubleshooting).

Backups & Wiederherstellung

Alle Flows, Credentials und Einstellungen liegen im Volume n8n_data unter /home/node/.n8n.

4.1 Manuelles Backup des Volumes

docker run --rm -v n8n_n8n_data:/data -v "$PWD":/backup busybox \
  sh -c 'tar czf /backup/n8n_data_$(date +%F_%H%M).tgz -C /data . && ls -lh /backup/*.tgz'

4.2 Wiederherstellung

1. n8n stoppen: docker compose down
2. Backup entpacken:
   RestoreKopieren

   docker run --rm -v n8n_n8n_data:/data -v "$PWD":/backup busybox \
     sh -c 'rm -rf /data/*; tar xzf /backup/DEIN_BACKUP.tgz -C /data'

3. Besitzrechte fixen (wichtig):
   RechteKopieren

   docker run --rm -v n8n_n8n_data:/data busybox \
     sh -c 'chown -R 1000:1000 /data'

4. n8n starten: docker compose up -d

Troubleshooting (häufige Fälle)

docker compose ps && docker compose logs -n 200 n8n

Domain & TLS mit Caddy (Reverse‑Proxy)

Für eigenen Server (z. B. Hetzner). Voraussetzung: A‑Record zeigt auf deine Server‑IP.

n8n.example.com {
  encode zstd gzip
  reverse_proxy n8n:5678
}

Compose‑Zusatz (Caddy neben n8n betreiben):

services:
  caddy:
    image: caddy:2
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    depends_on: [n8n]
volumes:
  caddy_data:
  caddy_config:

FAQ

Ist das kostenlos? n8n Community‑Edition ist kostenlos. Eigene Server‑Kosten (z. B. Hetzner) fallen separat an.

Bleibt der Dienst nach Neustart erreichbar? Ja. restart: unless-stopped sorgt dafür, dass Docker den Container beim Systemstart wieder startet.

Wo liegen meine Daten? Im Docker‑Volume n8n_data (/home/node/.n8n). Sichere dieses Volume regelmäßig (siehe Kapitel 4).

Wie sichere ich den Zugriff? Nutze Basic‑Auth, setze einen starken N8N_ENCRYPTION_KEY, und betreibe n8n hinter einem TLS‑Proxy (Caddy/Traefik/Nginx).

Cheat‑Sheet (Copy & Paste)

mkdir -p ~/n8n && cd ~/n8n

cat > docker-compose.yml <<'YAML'
services:
  n8n:
    image: n8nio/n8n:latest
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    restart: unless-stopped
volumes:
  n8n_data:
YAML

docker compose up -d
# ...später stoppen:
docker compose down

docker compose logs -n 200 n8n