n8n – Installation und Einrichtung

n8n ist ein kostenloses Open-Source-Tool zur Workflow-Automatisierung mit einer visuellen Oberfläche. Es verbindet Apps und Dienste miteinander – ähnlich wie Zapier oder Make, aber auf deinem eigenen Server. Mit n8n auf deinem NexoraHost VPS oder Rootserver sparst du teure Abo-Gebühren und behältst die volle Kontrolle über deine Daten.

Hinweis: Detaillierte Unterseiten zu ersten Workflows und komplexen Automatisierungen findest du in der linken Navigation.

Warum n8n selbst hosten?

• Keine monatlichen Kosten – der Self-Hosted-Plan ist komplett kostenlos und unbegrenzt
• Unbegrenzt viele Workflows, Benutzer und Ausführungen
• Volle Kontrolle über deine Daten – ideal für DSGVO-konforme Automatisierungen
• Über 400 Integrationen: Google, Slack, Discord, Telegram, Datenbanken, E-Mail und vieles mehr
• Extrem erweiterbar durch eigene Nodes und benutzerdefinierten JavaScript/TypeScript-Code

Voraussetzungen

• Einen VPS oder Rootserver mit Ubuntu 22.04/24.04 (andere Linux-Distributionen funktionieren ähnlich)
• SSH-Zugang mit root-Rechten
• Mindestens 2 GB RAM (4 GB empfohlen für komplexe Workflows)
• Eine eigene Domain mit SSL (dringend empfohlen für sicheren Zugriff)
• Docker und Docker-Compose (installieren wir in Schritt 1)

Schritt 1: Docker installieren

Docker ist die sauberste Methode, da alle Abhängigkeiten im Container isoliert sind:

# Docker installieren (Ubuntu/Debian)
sudo apt update
sudo apt install docker.io docker-compose -y

# Docker beim Systemstart aktivieren
sudo systemctl enable --now docker

# Aktuellen Benutzer zur Docker-Gruppe hinzufügen (erspart sudo bei jedem Befehl)
sudo usermod -aG docker $USER

Nach dem Hinzufügen zur Gruppe einmal ab- und wieder anmelden, damit die Änderung wirksam wird.

Schritt 2: Ordnerstruktur vorbereiten

# Hauptverzeichnis für n8n
mkdir -p ~/n8n && cd ~/n8n

# Unterordner für Daten und Backups
mkdir -p {n8n_data,backup}

Schritt 3: n8n mit Docker-Compose starten

Erstelle die docker-compose.yml:

nano ~/n8n/docker-compose.yml

Füge folgenden Inhalt ein:

version: '3.8'
services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=dein-sicheres-passwort
      - NODE_ENV=production
      - N8N_HOST=n8n.deine-domain.de
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.deine-domain.de
      - N8N_ENCRYPTION_KEY=dein-zufalls-generierter-key
      - N8N_USER_MANAGEMENT_DISABLED=false
      - N8N_DIAGNOSTICS_ENABLED=false
      - GENERIC_TIMEZONE=Europe/Berlin
      - TZ=Europe/Berlin
    ports:
      - 5678:5678
    volumes:
      - ./n8n_data:/home/node/.n8n
    restart: unless-stopped

Wichtige Umgebungsvariablen erklärt:

• N8N_BASIC_AUTH_ACTIVE / _USER / _PASSWORD: Aktiviert den Login-Schutz. Ohne diese Einstellung kann jeder auf dein n8n zugreifen
• N8N_HOST / N8N_PROTOCOL: Deine Domain – wichtig für korrekte Weiterleitungen
• WEBHOOK_URL: Die Basis-URL für eingehende Webhooks. Ohne diese funktionieren Webhooks von externen Diensten nicht
• N8N_ENCRYPTION_KEY: Verschlüsselt Anmeldedaten in der Datenbank. Generiere einen zufälligen Key (z.B. mit openssl rand -hex 32)
• N8N_USER_MANAGEMENT_DISABLED: false = Mehrbenutzer-Modus aktiv (jeder braucht einen Account)

Starte den Container:

cd ~/n8n
docker-compose up -d

Schritt 4: n8n im Browser einrichten

1. Rufe http://deine-server-ip:5678 im Browser auf
2. Melde dich mit den in der docker-compose.yml festgelegten Zugangsdaten an (admin / dein-sicheres-passwort)
3. Der Einrichtungsassistent führt dich durch die ersten Schritte:
   • Bestätige deine E-Mail-Adresse (optional, aber empfohlen für Benachrichtigungen)
   • Wähle ob du Diagnosedaten teilen möchtest (empfohlen: Nein)

Schritt 5: Ersten Workflow erstellen

Ein Workflow ist eine Kette von Aktionen. Hier ein einfaches Beispiel – eine E-Mail-Benachrichtigung bei einem Webhook-Aufruf:

1. Klicke auf New Workflow
2. Füge einen Webhook-Node hinzu (aus der Liste "Trigger")
3. Konfiguriere den Webhook:
   • HTTP Method: POST
   • Path: /mein-erster-webhook
   • Response Mode: Last Node
4. Füge einen E-Mail-Node hinzu (aus "Communication")
5. Konfiguriere die E-Mail:
   • To: [email protected]
   • Subject: Neuer Webhook-Aufruf!
   • Text: Der Webhook wurde um {{ $json.timestamp }} aufgerufen
6. Verbinde die Nodes per Drag-and-Drop
7. Klicke auf Execute Workflow zum Testen
8. Nach erfolgreichem Test: Active-Schalter oben rechts umlegen

Schritt 6: Externen Zugriff mit SSL absichern

Damit du n8n sicher von unterwegs erreichst und Webhooks funktionieren, brauchst du einen Reverse Proxy mit SSL:

# Nginx installieren
sudo apt install nginx certbot python3-certbot-nginx -y

# Nginx-Konfiguration erstellen
sudo nano /etc/nginx/sites-available/n8n

server {
    listen 80;
    server_name n8n.deine-domain.de;

    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 120s;
    }
}

# Seite aktivieren
sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

# SSL-Zertifikat holen
sudo certbot --nginx -d n8n.deine-domain.de

Schritt 7: n8n aktualisieren

n8n erhält regelmäßig Updates mit neuen Nodes und Features. So aktualisierst du sicher:

# Backup erstellen
cd ~/n8n
tar -czf backup/n8n_$(date +%Y%m%d_%H%M).tar.gz n8n_data

# Neueste Version pullen und Container neustarten
docker-compose pull
docker-compose up -d

# Alte Docker-Images aufräumen
docker image prune -f

Schritt 8: Wichtige Einstellungen für den Produktivbetrieb

E-Mail für Benachrichtigungen konfigurieren

1. Gehe zu Settings → Email
2. Trage deine SMTP-Daten ein (z.B. von deinem NexoraHost-Webspace)
3. Teste die Verbindung mit "Send Test Email"

Backup der Workflows

Neben dem automatischen Datei-Backup kannst du Workflows auch manuell exportieren:

1. Öffne einen Workflow
2. Klicke auf die drei Punkte oben rechts → Download
3. Die JSON-Datei enthält den kompletten Workflow und kann jederzeit importiert werden

Benutzerverwaltung

Wenn N8N_USER_MANAGEMENT_DISABLED=false gesetzt ist, kannst du weitere Benutzer einladen:

1. Gehe zu Settings → Users
2. Klicke auf Invite User
3. Vergib eine E-Mail-Adresse und wähle die Rolle (Member oder Admin)
4. Der Benutzer erhält eine Einladungs-E-Mail

Häufige Probleme und Lösungen

Webhooks funktionieren nicht von außen:

• Prüfe ob die WEBHOOK_URL-Umgebungsvariable korrekt gesetzt ist
• Prüfe ob der Reverse Proxy korrekt läuft: sudo nginx -t
• Stelle sicher, dass Port 443 in der Firewall offen ist

n8n startet nicht oder crasht:

• Prüfe die Logs: docker logs n8n
• Häufigste Ursache: N8N_ENCRYPTION_KEY wurde nachträglich geändert – dabei gehen alle gespeicherten Zugangsdaten verloren
• Falls der Key verloren ist: Container stoppen, alten Key aus den Logs suchen oder Datenbank zurücksetzen

Workflow läuft langsam:

• Prüfe die Server-Ressourcen mit htop
• Komplexe Workflows mit vielen HTTP-Requests können Minuten dauern – erhöhe das Timeout mit EXECUTIONS_TIMEOUT
• Erwäge ein Upgrade auf einen größeren VPS mit mehr RAM

Nützliche Tipps für den Einstieg

• Vorlagen nutzen: n8n bietet hunderte fertige Workflow-Vorlagen. Klicke auf Templates in der linken Seitenleiste
• Cron-Trigger: Mit dem "Schedule"-Node kannst du Workflows zeitgesteuert ausführen – z.B. täglich um 8 Uhr einen Bericht versenden
• Fehlerbehandlung: Jeder Node hat einen "Error"-Ausgang. Verbinde ihn mit einem Benachrichtigungs-Node um über Fehler informiert zu werden
• Sub-Workflows: Lagere wiederkehrende Logik in separate Workflows aus und rufe sie per "Execute Workflow"-Node auf

Ausführliche Anleitungen zu einzelnen Nodes, API-Integrationen und komplexen Automatisierungen findest du in den Artikeln der linken Navigation.