n8n auf Ubuntu 24.04 installieren: Docker-Setup mit Nginx Reverse Proxy & TLS

n8n ist eine Open-Source-Automatisierungsplattform, mit der du unterschiedliche Dienste miteinander verknüpfen und wiederkehrende Aufgaben über eine intuitive, node-basierte visuelle Oberfläche automatisieren kannst. Das Tool bietet viele Integrationen und verbindet No-Code- mit Low-Code-Funktionen, um auch komplexe Workflow-Strukturen aufzubauen.

Diese Anleitung führt dich durch die Installation und Konfiguration von n8n auf Ubuntu 24.04 per Docker, das Einrichten von Nginx als Reverse Proxy sowie das Absichern des Zugriffs mit TLS-Zertifikaten.

Voraussetzungen

Bevor du startest, stelle sicher, dass Folgendes vorhanden ist:

• Zugriff auf einen Ubuntu-24.04-Server über einen Nicht-Root-Benutzer mit sudo-Rechten.
• Ein eingerichteter DNS-A-Record, der auf die öffentliche IP deines Servers zeigt, zum Beispiel n8n.example.com.

Docker und Docker Compose installieren

Aktualisiere zuerst die Paketlisten deines Systems.

Konsole

$ sudo apt update

Installiere anschließend die benötigten Pakete für die Verwaltung des Docker-Repositories.

$ sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

Füge den offiziellen GPG-Schlüssel von Docker hinzu.

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Registriere das Docker-Repository in deiner Ubuntu-Installation.

$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Aktualisiere danach erneut den Paketindex.

$ sudo apt update

Installiere die Docker Engine, die Docker-CLI sowie das Docker-Compose-Plugin.

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

Füge deinen Benutzer zur docker-Gruppe hinzu, damit du Docker-Befehle ohne sudo ausführen kannst.

$ sudo usermod -aG docker $USER

Aktiviere die neue Gruppenmitgliedschaft in der aktuellen Sitzung.

$ newgrp docker

Prüfe, ob Docker korrekt läuft.

$ docker --version

Verzeichnisstruktur für n8n anlegen

Im nächsten Schritt richtest du eine eigene Ordnerstruktur für die n8n-Konfiguration und dauerhafte Daten ein.

Erstelle das Hauptverzeichnis für n8n.

$ mkdir ~/n8n

Wechsle in den neu erstellten Ordner.

$ cd ~/n8n

Lege einen Unterordner für persistente n8n-Daten an.

$ mkdir n8n-data

Erstelle außerdem einen Ordner für lokale Dateien, die in Workflows genutzt werden sollen.

$ mkdir local-files

Da der n8n-Container unter UID 1000 arbeitet, passe die Besitzrechte entsprechend an.

$ sudo chown -R 1000:1000 n8n-data local-files

Docker Compose für n8n konfigurieren

Jetzt erstellst du die Docker-Compose-Datei zum Starten von n8n.

Lege die Datei docker-compose.yml an.

$ nano docker-compose.yml

Füge folgende Konfiguration ein und ersetze n8n.example.com durch deine Domain.

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.example.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.example.com
      - N8N_EDITOR_BASE_URL=https://n8n.example.com
      - GENERIC_TIMEZONE=UTC
      - N8N_USER_FOLDER=/home/node/.n8n
    volumes:
      - ./n8n-data:/home/node/.n8n
      - ./local-files:/files
    networks:
      - n8n-network

networks:
  n8n-network:
    driver: bridge

Speichere die Datei und schließe den Editor.

Mit dieser Definition startest du einen n8n-Container mit dauerhaftem Speicher, Webhook-Unterstützung und allen relevanten HTTPS-Variablen.

Nginx installieren und einrichten

Nginx fungiert als Reverse Proxy, beendet HTTPS und leitet die Anfragen an den n8n-Container weiter.

Installiere Nginx über den Paketmanager.

$ sudo apt install nginx -y

Erstelle einen neuen Server-Block in Nginx und ersetze die Domain durch deine eigene.

$ sudo nano /etc/nginx/sites-available/n8n.example.com

Trage danach diese Konfiguration ein und passe den Domainnamen an.

server {
    listen 80;
    server_name n8n.example.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_cache_bypass $http_upgrade;
        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_set_header X-Forwarded-Port $server_port;

        proxy_buffering off;

        proxy_read_timeout 300s;
        proxy_connect_timeout 75s;
    }
}

Diese Einstellungen unterstützen WebSockets und setzen längere Timeouts, was für n8n-Workflows sinnvoll ist.

Aktiviere die Site über einen symbolischen Link.

$ sudo ln -s /etc/nginx/sites-available/n8n.example.com /etc/nginx/sites-enabled/

Überprüfe die Nginx-Konfiguration auf Fehler.

$ sudo nginx -t

Lade Nginx neu, um die Änderungen zu übernehmen.

$ sudo systemctl reload nginx

Firewall-Regeln konfigurieren

Richte nun die Firewall so ein, dass der notwendige Netzwerkverkehr erlaubt wird.

Erlaube vorübergehend HTTP-Traffic (für die Zertifikatsvalidierung erforderlich).

$ sudo ufw allow 80/tcp

Aktiviere HTTPS, damit sichere Verbindungen möglich sind.

$ sudo ufw allow 443/tcp

Certbot installieren und TLS-Zertifikate anwenden

Certbot übernimmt die Ausstellung und automatische Erneuerung von TLS-Zertifikaten über Let’s Encrypt.

Installiere Certbot sowie das Nginx-Plugin.

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

Fordere ein Zertifikat für deine Domain an und passe Domain sowie E-Mail-Adresse bei Bedarf an.

$ sudo certbot --nginx -d n8n.example.com --email admin@example.com --agree-tos --non-interactive

Certbot ergänzt deine Nginx-Konfiguration automatisch um TLS-Einstellungen und richtet die Zertifikatserneuerung ein.

Teste anschließend den Erneuerungsmodus.

$ sudo certbot renew --dry-run

Wenn der Testlauf ohne Fehler durchläuft, ist die automatische Verlängerung korrekt eingerichtet.

n8n starten

Hier erfährst du, wie du n8n per Docker Compose startest und prüfst, ob alles funktioniert.

Wechsle in das n8n-Verzeichnis.

$ cd ~/n8n

Starte n8n im Hintergrund.

$ docker compose up -d

Kontrolliere, ob der Container korrekt läuft.

$ docker compose ps

Sieh dir die Logs an, um eine erfolgreiche Initialisierung zu bestätigen.

$ docker logs n8n

Beispielausgabe:

...

n8n ready on https://n8n.example.com

n8n aufrufen und konfigurieren

Schließe die Einrichtung ab, indem du ein Admin-Konto anlegst und die ersten Einstellungen vornimmst.

Öffne deinen Browser und rufe folgende Adresse auf:

https://n8n.example.com

Erstelle dein Administrator-Profil, indem du Namen, E-Mail und Passwort eingibst.

Nach dem Login kannst du den n8n-Workflow-Editor nutzen, um Automatisierungen aufzubauen.

Sieh dir vorhandene Vorlagen an oder entwirf deine eigenen Workflow-Agenten.

n8n-Container verwalten

Mit den folgenden Befehlen steuerst du deine laufende n8n-Umgebung.

Logs anzeigen

Beobachte die Logs in Echtzeit.

$ docker logs -f n8n

n8n stoppen

Beende den Container sauber.

$ docker compose down

n8n neu starten

Starte den n8n-Container erneut.

$ docker compose restart

n8n aktualisieren

Wechsle auf die aktuellste n8n-Version.

$ docker compose pull
$ docker compose up -d

Fazit

Du hast n8n auf Ubuntu 24.04 mit Docker installiert, einen Nginx-Reverse-Proxy eingerichtet und TLS-Verschlüsselung aktiviert. Damit ist deine n8n-Instanz bereit, Automatisierungen zu erstellen. Durch das Container-Setup werden Updates, Wartung und Skalierung deutlich einfacher, während deine Automatisierungsanforderungen wachsen. Für weitere Informationen kannst du die offizielle n8n-Dokumentation nutzen.