n8n unter Ubuntu 24.04 installieren

Warum n8n auf Ubuntu installieren?

n8n ist eine der leistungsfähigsten Open-Source-Plattformen für Workflow-Automatisierung, die es gibt – man kann es sich wie ein selbst gehostetes Zapier vorstellen, das Ihnen die volle Kontrolle über Ihre Daten, Infrastruktur und Kosten gibt. Mit nativen AI/LLM-Nodes können Sie agentische Workflows erstellen, die Ihren gesamten Tech-Stack miteinander verbinden.

Der Betrieb auf Ubuntu 24.04 ist die ideale Lösung: Sie erhalten den Long-Term-Support eines stabilen Betriebssystems, die Portabilität von Docker und die volle Hoheit über Ihre Automatisierungsdaten. Keine Gebühren pro Ausführung, keine Ratenbegrenzungen, kein Vendor-Lock-in.

Voraussetzungen

• Ubuntu 24.04 Server (LTS)
• Mindestens 2 CPU-Kerne, 4 GB RAM (8 GB für komplexe Workflows empfohlen)
• 20 GB+ freier Festplattenspeicher
• Docker und Docker Compose installiert
• Port 5678 verfügbar (n8n-Standard)
• Ein Domainname, der auf Ihren Server verweist (empfohlen für HTTPS)

Schritt 1: Docker installieren (falls noch nicht geschehen)

Ubuntu 24.04 macht die Docker-Installation unkompliziert. Führen Sie diese Befehle aus:

# System aktualisieren
sudo apt update && sudo apt upgrade -y

# Docker-Voraussetzungen installieren
sudo apt install -y ca-certificates curl gnupg lsb-release

# Offiziellen GPG-Schlüssel von Docker hinzufügen
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Docker-Repository hinzufügen
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

# Docker installieren
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Installation überprüfen
sudo docker --version
sudo docker compose version

Fügen Sie Ihren Benutzer zur Docker-Gruppe hinzu, um Docker ohne sudo auszuführen:

sudo usermod -aG docker $USER
# Melden Sie sich ab und wieder an, damit dies wirksam wird

Schritt 2: n8n mit Docker Compose bereitstellen

Erstellen Sie ein Verzeichnis und eine docker-compose.yml-Datei. Dies ist der wartungsfreundlichste Weg, um n8n produktiv zu betreiben:

mkdir -p ~/n8n
cd ~/n8n
nano docker-compose.yml

Fügen Sie diese Konfiguration ein:

services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    container_name: n8n
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.yourdomain.com
      - DB_TYPE=sqlite
      - DB_SQLITE_DATABASE=/home/node/.n8n/database.sqlite
      - N8N_ENCRYPTION_KEY=your-strong-encryption-key-here
      - N8N_METRICS=true
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=168
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./local_files:/files

🔐 Wichtig: Ersetzen Sie your-strong-encryption-key-here durch eine zufällige 32-stellige Zeichenfolge. Dieser Schlüssel verschlüsselt Ihre Anmeldedaten in der Datenbank – wenn Sie ihn verlieren, verlieren Sie den Zugriff auf alle verbundenen Dienste.

Starten Sie n8n:

docker compose up -d

Überprüfen Sie, ob es läuft:

docker compose logs -f    # Start-Logs beobachten
docker compose ps          # Sollte den Status "Up" anzeigen

Ihre n8n-Instanz ist jetzt unter http://IHRE_SERVER_IP:5678 erreichbar.

Schritt 3: Nginx als Reverse Proxy einrichten (für HTTPS)

n8n direkt auf Port 5678 freizugeben funktioniert zum Testen, aber für den produktiven Einsatz benötigen Sie HTTPS. Hier ist die Nginx-Konfiguration:

sudo apt install -y nginx certbot python3-certbot-nginx

sudo nano /etc/nginx/sites-available/n8n

Fügen Sie diese Konfiguration hinzu:

server {
    listen 80;
    server_name n8n.yourdomain.com;

    location / {
        proxy_pass http://localhost:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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 X-Forwarded-Host $host;
        proxy_buffering off;
    }
}

Aktivieren Sie die Seite und holen Sie sich ein SSL-Zertifikat:

sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# Let's Encrypt SSL-Zertifikat abrufen
sudo certbot --nginx -d n8n.yourdomain.com

Das war's – Ihre n8n-Instanz ist jetzt sicher unter https://n8n.yourdomain.com erreichbar.

Schritt 4: Umgebungsvariablen konfigurieren

n8n verfügt über Dutzende von Konfigurationsoptionen. Hier sind die wichtigsten für den produktiven Einsatz:

Variable	Zweck	Beispiel
N8N_ENCRYPTION_KEY	Verschlüsselt gespeicherte Anmeldedaten	32-stellige Zufallszeichenfolge
N8N_METRICS	Aktiviert den Prometheus-Metrik-Endpunkt	true
EXECUTIONS_DATA_PRUNE	Automatisches Löschen alter Ausführungsdaten	true
EXECUTIONS_DATA_MAX_AGE	Aufbewahrungsdauer der Ausführungshistorie (Stunden)	168 (7 Tage)
N8N_PAYLOAD_SIZE_MAX	Max. Webhook-Payload (MB)	16
N8N_METRICS_INCLUDE_DEFAULT_METRICS	Standard-Metriken einbeziehen	true

Schritt 5: Automatische Backups

Ihre n8n-Daten (Workflows, Anmeldedaten, Ausführungshistorie) werden im Verzeichnis ./n8n_data gespeichert. Richten Sie einen Cron-Job für tägliche Backups ein:

# Backup-Skript erstellen
sudo nano /usr/local/bin/backup-n8n.sh

#!/bin/bash
BACKUP_DIR="/backups/n8n"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR

# n8n kurz stoppen für ein konsistentes Backup
docker stop n8n

# Daten sichern
tar -czf "$BACKUP_DIR/n8n_backup_$TIMESTAMP.tar.gz" -C ~/n8n n8n_data/

# n8n neu starten
docker start n8n

# Nur die letzten 30 Backups behalten
ls -t $BACKUP_DIR/*.tar.gz | tail -n +31 | xargs -r rm

echo "Backup gespeichert: n8n_backup_$TIMESTAMP.tar.gz"

sudo chmod +x /usr/local/bin/backup-n8n.sh

# Zur Crontab hinzufügen – läuft täglich um 3 Uhr morgens
(crontab -l 2>/dev/null; echo "0 3 * * * /usr/local/bin/backup-n8n.sh") | crontab -

Schritt 6: n8n aktualisieren

n8n veröffentlicht häufig Updates. So aktualisieren Sie sicher:

cd ~/n8n

# Neuestes Image ziehen
docker compose pull

# Container mit neuem Image neu erstellen
docker compose up -d

# Überprüfen, ob es läuft
docker compose logs -f --tail=20

Überprüfen Sie vor größeren Versions-Updates immer das n8n-Changelog – einige Releases enthalten Breaking Changes oder Datenbank-Migrationen, die manuelle Schritte erfordern.

Fehlerbehebung bei häufigen Problemen

❌ Container beendet sich sofort

Überprüfen Sie die Logs mit docker compose logs. Die häufigste Ursache ist ein fehlender oder ungültiger N8N_ENCRYPTION_KEY. Stellen Sie sicher, dass er mindestens 32 Zeichen lang ist.

❌ Webhooks funktionieren nicht

Stellen Sie sicher, dass WEBHOOK_URL und N8N_HOST in Ihrer Umgebung korrekt gesetzt sind. Ohne diese generiert n8n Webhook-URLs mit localhost, die von externen Diensten nicht erreicht werden können.

❌ 502 Bad Gateway hinter Nginx

Überprüfen Sie, ob der proxy_pass-Port mit Ihrem n8n-Port übereinstimmt. Die WebSocket-Header (Upgrade, Connection) sind essenziell, damit der n8n-Editor hinter einem Reverse Proxy funktioniert.

❌ Langsame Workflow-Ausführung

Erhöhen Sie den RAM Ihres Servers. n8n hält Workflows während der Ausführung im Arbeitsspeicher, und komplexe Workflows mit über 100 Nodes können jeweils 2-4 GB verbrauchen.

Fazit

Die Installation von n8n auf Ubuntu 24.04 bietet Ihnen eine produktionsreife Workflow-Automatisierungsplattform, die vollständig auf Ihrer eigenen Infrastruktur läuft. Mit Docker Compose, Nginx Reverse Proxy und automatischen Backups verfügen Sie über ein Setup, das von der persönlichen Automatisierung bis hin zu Team-Workflows skaliert.

Das Beste daran? Keine Kosten pro Ausführung, keine monatlichen Abonnement-Stufen, keine Daten, die Ihren Server verlassen. Einfach pure Workflow-Automatisierung mit über 400+ Integrationen direkt ab Werk.