n8n Docker: Vollständige Installationsanleitung und Setup-Guide

curl -fsSL https://get.docker.com | bash

, konkrete Aussagen, abwechslungsreicher Rhythmus.

n8n läuft am stabilsten in einem Docker-Container. Du bekommst eine isolierte Umgebung, reproduzierbare Deployments und volle Kontrolle über deine Daten — ohne Abhängigkeiten vom Host-System. Diese Anleitung führt dich vom ersten docker pull bis zum produktionsreifen Setup mit PostgreSQL, Reverse Proxy und automatischen Updates.

Voraussetzungen für die n8n Docker-Installation

Bevor du startest, brauchst du Docker auf deinem System. Unter Ubuntu/Debian installierst du es mit einem einzigen Befehl:

curl -fsSL https://get.docker.com | bash

Für Docker Compose (Version 2) auf Linux führst du zusätzlich aus:

apt-get install docker-compose-plugin

Für das n8n-Setup empfiehlt sich ein Server mit mindestens 1 CPU-Kern, 1 GB RAM und 10 GB Speicher. Port 5678 muss in der Firewall freigegeben sein. Für ein Produktions-Setup mit PostgreSQL und Reverse Proxy solltest du 2 GB RAM einplanen.

Unter Windows läuft n8n Docker über WSL2 oder Docker Desktop. Für Produktionsumgebungen empfiehlt sich ein dedizierter Linux-Server oder ein VPS-Anbieter wie Hetzner oder DigitalOcean.

n8n mit Docker starten: Schritt-für-Schritt-Anleitung

Zuerst lädst du das offizielle n8n-Image von Docker Hub herunter:

docker pull n8nio/n8n

Der einfachste Weg zum ersten Start ist ein einzelner docker run-Befehl. Für einen schnellen Test ohne persistente Daten reicht:

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

Für den dauerhaften Betrieb mit persistentem Datenspeicher nutzt du ein Volume. Lege zunächst ein lokales Verzeichnis an und setze die richtigen Berechtigungen:

mkdir -p ~/.n8n
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  --restart unless-stopped \
  n8nio/n8n

Nach dem Start erreichst du die n8n-Oberfläche unter http://localhost:5678. Der Parameter --restart unless-stopped sorgt dafür, dass der Container nach einem Serverneustart automatisch wieder hochfährt.

Wichtige docker run-Parameter im Überblick

• -p 5678:5678: Mappt den Container-Port auf den Host-Port.
• -v ~/.n8n:/home/node/.n8n: Persistentes Volume für Workflows, credentials und SQLite-Datenbank.
• –restart unless-stopped: Automatischer Neustart bei Absturz oder Serverneustart.
• -d: Startet den Container im Hintergrund (detached mode).
• –name n8n: Vergibt einen sprechenden Namen für einfachere Verwaltung.

Umgebungsvariablen übergibst du mit dem -e-Flag. Für den Grundbetrieb setzt du mindestens die Zeitzone und eine Verschlüsselungskey für credentials:

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e GENERIC_TIMEZONE="Europe/Berlin" \
  -e N8N_ENCRYPTION_KEY="dein-sicherer-schluessel-hier" \
  --restart unless-stopped \
  n8nio/n8n

n8n mit Docker Compose einrichten

Für komplexere Setups mit mehreren Services ist Docker Compose der bessere Weg. Du definierst alle Container, Volumes und Umgebungsvariablen in einer einzigen docker-compose.yml-Datei und startest alles mit einem Befehl.

Lege zunächst ein Projektverzeichnis an:

mkdir ~/n8n-docker && cd ~/n8n-docker

Erstelle dann die docker-compose.yml:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=Europe/Berlin
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Dazu passend eine .env-Datei mit deinen Zugangsdaten:

N8N_ENCRYPTION_KEY=dein-langer-zufaelliger-schluessel
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=sicheres-passwort-hier

Starten und stoppen des Stacks geht so:

# Starten
docker compose up -d

# Logs verfolgen
docker compose logs -f n8n

# Stoppen
docker compose down

Mit docker compose up -d startet n8n im Hintergrund. Alle Workflows, credentials und data bleiben im benannten Volume n8n_data erhalten — auch wenn du den Container neu erstellst.

Aus der Praxis in Ihren Betrieb

Was wäre bei Ihnen automatisierbar?

Im kostenlosen Prozess-Audit zeigen wir Ihnen in 30 Minuten konkret, welche 3 Automationen sich bei Ihnen sofort lohnen, mit Einsparungs-Schätzung als PDF.

Prozess-Audit sichern

n8n mit PostgreSQL als Datenbank verwenden

Standardmäßig nutzt n8n SQLite. Für produktive Umgebungen mit vielen Workflows und hohem Durchsatz solltest du auf PostgreSQL umsteigen. PostgreSQL verarbeitet parallele Schreibzugriffe zuverlässiger und skaliert besser bei wachsenden Datenmengen.

Erweitere deine docker-compose.yml um einen PostgreSQL-Service:

version: '3.8'

services:
  postgres:
    image: postgres:15-alpine
    container_name: n8n_postgres
    restart: unless-stopped
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
      interval: 10s
      timeout: 5s
      retries: 5

  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      - GENERIC_TIMEZONE=Europe/Berlin
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:
  postgres_data:

Die zugehörige .env-Datei:

N8N_ENCRYPTION_KEY=dein-langer-zufaelliger-schluessel
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=sicheres-passwort-hier
POSTGRES_USER=n8n
POSTGRES_PASSWORD=sicheres-db-passwort
POSTGRES_DB=n8n

Der healthcheck stellt sicher, dass PostgreSQL vollständig gestartet ist, bevor n8n die Verbindung aufbaut. Das verhindert Startfehler bei langsamen Systemen.

n8n mit Tunnel für externe Erreichbarkeit konfigurieren

Für Webhooks und externe Integrationen muss dein n8n-Server von außen erreichbar sein. Der integrierte tunnel-Modus von n8n baut dafür automatisch eine öffentliche URL auf — ohne eigene Domain oder Firewall-Konfiguration. Das ist ideal für Tests und Entwicklung.

Den tunnel-Modus aktivierst du über die Umgebungsvariable:

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e N8N_TUNNEL=true \
  -e GENERIC_TIMEZONE="Europe/Berlin" \
  --restart unless-stopped \
  n8nio/n8n

In der docker-compose.yml fügst du die Variable unter environment ein:

environment:
  - N8N_TUNNEL=true
  - N8N_TUNNEL_SUBDOMAIN=mein-n8n-tunnel

n8n generiert dann eine URL im Format https://[subdomain].hooks.n8n.cloud. Diese URL trägst du als Webhook-Ziel in externen Services wie Google, Stripe oder Slack ein. Für Produktionsumgebungen empfiehlt sich eine eigene Domain mit Reverse Proxy statt des tunnel-Modus.

Webhook-URL für Produktion setzen

Auf einem Server mit eigener Domain setzt du die Webhook-URL explizit:

environment:
  - WEBHOOK_URL=https://n8n.deinedomain.de/

n8n verwendet diese URL dann für alle automatisch generierten Webhook-Pfade in deinen Workflows.

Credentials und Google-Integrationen in n8n einrichten

n8n speichert alle credentials verschlüsselt in der Datenbank. Der Schlüssel dafür ist die Umgebungsvariable N8N_ENCRYPTION_KEY. Verlierst du diesen Schlüssel, verlierst du den Zugang zu allen gespeicherten Zugangsdaten — notiere ihn daher an einem sicheren Ort.

Google-Integrationen (Gmail, Google Sheets, Google Drive) richten sich über OAuth 2.0 ein. Der Ablauf:

• Google Cloud Console: Projekt anlegen, OAuth 2.0-Client-ID erstellen (Typ: Webanwendung).
• Redirect URI: https://n8n.deinedomain.de/rest/oauth2-credential/callback eintragen.
• Client-ID und Client-Secret: In n8n unter Settings → Credentials als neue Google-Credential hinterlegen.
• Autorisierung: Den OAuth-Flow einmalig durchlaufen, n8n speichert den Refresh-Token automatisch.

Für Google-Service-Accounts (bei serverseitigen Integrationen ohne Nutzer-Interaktion) lädst du die JSON-Schlüsseldatei direkt in die n8n-Credentials hoch. Service-Accounts eignen sich für automatisierte Workflows, die ohne menschlichen Eingriff laufen sollen.

Credentials gelten global innerhalb einer n8n-Instanz und können von mehreren Workflows genutzt werden. Das spart Konfigurationsaufwand bei komplexen Automatisierungsprojekten. Wer professionelle Workflow-Automatisierung betreibt, profitiert besonders von dieser zentralen Verwaltung.

Trigger und erste Workflows erstellen

Jeder n8n-Workflow beginnt mit einem trigger-Node. Der Trigger bestimmt, wann ein Workflow ausgeführt wird. n8n bietet drei grundlegende Trigger-Typen:

• Webhook-Trigger: Startet den Workflow bei einem HTTP-Request von außen (z.B. von Stripe, GitHub oder deiner eigenen App).
• Cron-Trigger: Führt den Workflow nach einem Zeitplan aus — z.B. täglich um 08:00 Uhr.
• Chat-Trigger: Startet einen Workflow über das integrierte Chat-Interface von n8n, ideal für KI-gestützte Automatisierungen.

Ein einfacher erster Workflow: HTTP-Request auf eine externe API, Daten transformieren, Ergebnis per E-Mail versenden. Dafür brauchst du drei Nodes: Webhook (trigger), HTTP Request (node), Send Email (node). Das ist in unter fünf Minuten aufgebaut.

Chat-Workflows mit KI-Nodes

n8n bringt native Integration für OpenAI, Anthropic Claude und andere LLM-Anbieter. Mit dem Chat-Trigger und einem AI Agent-Node baust du einen vollwertigen KI-Assistenten, der auf Nutzereingaben reagiert und externe APIs aufruft. Das ist der schnellste Weg zu einem KI-Chatbot für deine Website ohne eigenen Backend-Code.

Für produktive KI-Workflows speicherst du den Gesprächsverlauf in einer PostgreSQL-Tabelle. Der Memory-Node von n8n übernimmt das automatisch, solange du die Datenbank-Credentials korrekt hinterlegt hast.

n8n Docker aktualisieren: Update-Anleitung

n8n veröffentlicht regelmäßig neue Versionen mit Bug-Fixes und neuen Nodes. Das Update-Verfahren ist bei Docker unkompliziert und dauert unter zwei Minuten.

Für ein Setup mit docker run:

# Neues Image laden
docker pull n8nio/n8n

# Alten Container stoppen und entfernen
docker stop n8n
docker rm n8n

# Container mit neuem Image neu starten
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e GENERIC_TIMEZONE="Europe/Berlin" \
  -e N8N_ENCRYPTION_KEY="dein-schluessel" \
  --restart unless-stopped \
  n8nio/n8n

Mit Docker Compose geht das n8n update noch schneller:

# Neues Image laden
docker compose pull

# Container neu erstellen und starten
docker compose up -d --force-recreate

Deine Daten bleiben dabei vollständig erhalten, weil sie im Volume liegen — nicht im Container selbst. Vor größeren Updates empfiehlt sich ein Backup des Volumes:

# Backup der n8n-Daten
docker run --rm \
  -v n8n_data:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/n8n-backup-$(date +%Y%m%d).tar.gz /data

Spezifische Version installieren

Wenn du eine bestimmte n8n-Version erzwingen willst, ersetzt du n8nio/n8n durch n8nio/n8n:1.45.0 (oder eine andere Versionsnummer). Eine Übersicht aller verfügbaren Tags findest du auf der n8n Docker Hub Seite.

Full-Stack-Setup: n8n auf einem eigenen Server betreiben

Für ein produktionsreifes n8n Docker-Setup auf einem VPS brauchst du zusätzlich einen Reverse Proxy mit SSL. Nginx Proxy Manager ist dabei die einfachste Lösung — er verwaltet Let’s Encrypt-Zertifikate automatisch.

Erweiterter docker-compose.yml Stack mit Nginx Proxy Manager:

version: '3.8'

networks:
  web:
    external: true

services:
  postgres:
    image: postgres:15-alpine
    container_name: n8n_postgres
    restart: unless-stopped
    networks:
      - web
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
      interval: 10s
      timeout: 5s
      retries: 5

  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    networks:
      - web
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      - GENERIC_TIMEZONE=Europe/Berlin
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_PROTOCOL=https
      - N8N_HOST=n8n.deinedomain.de
      - WEBHOOK_URL=https://n8n.deinedomain.de/
      - N8N_EDITOR_BASE_URL=https://n8n.deinedomain.de/
    volumes:
      - n8n_data:/home/node/.n8n

  nginx-proxy-manager:
    image: jc21/nginx-proxy-manager:latest
    container_name: nginx-proxy-manager
    restart: unless-stopped
    networks:
      - web
    ports:
      - "80:80"
      - "443:443"
      - "81:81"
    volumes:
      - npm_data:/data
      - npm_letsencrypt:/etc/letsencrypt

volumes:
  n8n_data:
  postgres_data:
  npm_data:
  npm_letsencrypt:

Das externe Netzwerk web erstellst du einmalig mit:

docker network create web

Anschließend rufst du den Nginx Proxy Manager unter http://server-ip:81 auf, loggst dich mit den Standard-Credentials ein und richtest einen neuen Proxy-Host für n8n.deinedomain.de ein — Ziel: n8n:5678. SSL aktivierst du direkt im Interface mit einem Klick auf “Request a new SSL certificate”.

n8n als systemd-Service absichern

Damit der Docker Compose Stack nach einem Serverneustart automatisch startet, genügt ein einfaches systemd-Unit-File:

[Unit]
Description=n8n Docker Compose Stack
Requires=docker.service
After=docker.service

[Service]
WorkingDirectory=/root/n8n-docker
ExecStart=/usr/bin/docker compose up
ExecStop=/usr/bin/docker compose down
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Speichere die Datei unter /etc/systemd/system/n8n.service und aktiviere den Service:

systemctl daemon-reload
systemctl enable n8n
systemctl start n8n

Wer professionelle KI-Automatisierung aufbauen möchte und die technische Einrichtung lieber delegiert, findet bei einer spezialisierten KI-Agentur den passenden Partner für Konzeption und Umsetzung.

Häufige Probleme und Lösungen (Troubleshooting)

Port 5678 bereits belegt

Wenn der Container nicht startet und die Logs address already in use zeigen, nutzt ein anderer Prozess Port 5678. Überprüfe mit:

lsof -i :5678

Entweder beendest du den konfliktierenden Prozess oder du mappst n8n auf einen anderen Port, z.B. -p 5679:5678.

Volume-Berechtigungsfehler

n8n läuft im Container als User mit UID 1000. Wenn das Host-Verzeichnis einem anderen User gehört, schlägt der Container-Start fehl. Die Lösung:

chown -R 1000:1000 ~/.n8n

Bei benannten Docker-Volumes übernimmt Docker die Berechtigungen automatisch — diese Problematik tritt nur bei Bind-Mounts auf.

PostgreSQL-Verbindung schlägt fehl

Wenn n8n mit connection refused oder ECONNREFUSED startet, ist PostgreSQL noch nicht bereit. Prüfe zunächst den Healthcheck-Status:

docker compose ps

Zeigt PostgreSQL den Status healthy? Falls nicht, erhöhe den retries-Wert im Healthcheck oder füge eine start_period hinzu. Alternativ prüfst du die Datenbankverbindung direkt:

docker compose exec postgres psql -U n8n -d n8n -c "\l"

n8n-Container startet, UI nicht erreichbar

Prüfe zunächst, ob der Container tatsächlich läuft:

docker ps -a | grep n8n

Lies dann die Logs auf Fehlermeldungen:

docker logs n8n --tail 50

Häufige Ursachen: fehlender N8N_ENCRYPTION_KEY, falsche Datenbankzugangsdaten oder ein blockierter Port in der Firewall. Unter Ubuntu öffnest du Port 5678 mit:

ufw allow 5678/tcp

Workflows nach Update verschwunden

Das passiert, wenn du den Container mit docker rm -v gelöscht hast — das -v-Flag entfernt auch das Volume. Ohne -v bleiben alle data erhalten. Für die Zukunft: regelmäßige Backups des Volumes automatisieren und als Cronjob auf dem Server einrichten.

Häufige Fragen (FAQ)

Welchen Port nutzt n8n standardmäßig?

n8n hört standardmäßig auf Port 5678. Du änderst den Host-Port durch Anpassen des Port-Mappings beim docker run-Befehl: -p 8080:5678 lässt n8n unter Port 8080 erreichbar sein, während es intern weiterhin auf 5678 läuft.

Wie erstelle ich ein Backup meiner n8n-Daten?

Das einfachste Backup-Verfahren für Docker-Volumes:

docker run --rm \
  -v n8n_data:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/n8n-backup-$(date +%Y%m%d).tar.gz /data

Damit erstellst du ein komprimiertes Archiv aller n8n-Daten im aktuellen Verzeichnis. Plane diesen Befehl als täglichen Cron-Job ein und speichere die Backups auf einem externen Speicher.

Wie speichere ich n8n-Credentials sicher?

Alle credentials werden mit dem Wert aus N8N_ENCRYPTION_KEY AES-256-verschlüsselt in der Datenbank gespeichert. Setze diesen Key in der .env-Datei und füge .env zur .gitignore hinzu. Den Key selbst lagerst du sicher in einem Passwort-Manager oder Secret-Management-System wie HashiCorp Vault.

Kann ich mehrere n8n-Instanzen auf einem Server betreiben?

Ja. Jede Instanz braucht einen eigenen Port, ein eigenes Volume und eine eigene Datenbank. Mit Docker Compose legst du für jede Instanz ein separates Projektverzeichnis an. Unterschiedliche Subdomains (z.B. n8n-dev.domain.de und n8n-prod.domain.de) trennst du über separate Reverse-Proxy-Konfigurationen.

Wie aktiviere ich die n8n-Benutzerverwaltung?

Ab n8n Version 0.195 ist das User-Management-Feature standardmäßig aktiv. Du richtest den ersten Admin-Account beim ersten Login über die UI ein. Setze zusätzlich N8N_EMAIL_MODE=smtp mit passenden SMTP-Credentials, damit n8n Einladungs-E-Mails verschicken kann.

Wie verbinde ich n8n Docker mit einer externen PostgreSQL-Datenbank?

Setze DB_POSTGRESDB_HOST auf die IP-Adresse oder den Hostnamen deiner externen Datenbank statt auf den internen Container-Namen. Stelle sicher, dass der PostgreSQL-Server Verbindungen von der IP deines Docker-Hosts akzeptiert und dass der Port 5432 in der Firewall offen ist.

Wie sehe ich, welche n8n-Version ich gerade nutze?

Direkt über Docker:

docker exec n8n n8n --version

Alternativ siehst du die Version unten links in der n8n-Weboberfläche unter dem Menüpunkt “About”.

Was passiert mit laufenden Workflows beim Update?

Aktive Workflow-Ausführungen werden beim Container-Neustart abgebrochen. Plane Updates daher in Wartungsfenstern mit geringer Workflow-Last. n8n protokolliert abgebrochene Ausführungen im Execution-Log — du kannst sie nach dem Update manuell neu starten.

—