n8n Docker ist der Weg, den n8n selbst für jede eigene Installation empfiehlt: Die Software läuft in Containern, die du mit Docker Compose startest, aktualisierst und sicherst. Ab n8n 3.0 gibt es laut Dokumentation kein lauffähiges npm-Paket mehr, Docker ist dann der einzige unterstützte Weg. Diese Seite zeigt die Befehle aus der offiziellen Dokumentation, Stand November 2026. Ob sich Selbsthosten für dich lohnt, welcher Server reicht und was beim Datenschutz gilt, steht unter n8n self hosted.
Voraussetzungen
Du brauchst Docker mit dem Compose-v2-Plugin, also den Befehl docker compose und nicht das alte Programm docker-compose. Der Docker-Dienst muss laufen. Auf Mac und Windows bringt Docker Desktop beides mit, auf einem Linux-Server installierst du Docker Engine und das Compose-Plugin als Pakete. Unter Windows startest du die Befehle in WSL mit eingeschalteter WSL2-Integration von Docker Desktop.
Für den Produktivbetrieb empfiehlt n8n einen 64-Bit-Linux-Server. Welche Größe reicht und was sie kostet, zeigt n8n self hosted.
| Weg | Wofür | Datenbank |
|---|---|---|
| One-line setup | schneller Start, Test | SQLite |
| Docker Compose | Server, Team, Produktion | SQLite oder PostgreSQL |
| docker run | kurzer lokaler Test | SQLite oder PostgreSQL |
Weg 1: n8n installieren mit einem Befehl
Läuft Docker, reicht ein Befehl:
curl -fsSL https://get.n8n.io | sh
Willst du das Skript vorher lesen, lädst du es zuerst herunter:
curl -fsSL https://get.n8n.io -o get-n8n.sh
less get-n8n.sh
sh get-n8n.sh
Das Skript legt einen Ordner n8n an mit compose.yml, searxng-settings.yml und einer .env mit eigenen Schlüsseln. Dazu kommt das Docker-Volume n8n-data. n8n läuft danach unter http://localhost:5678, der erste Start kann einige Minuten dauern. Mit --version 2.48.7 am Ende des Befehls installierst du eine bestimmte Version, mit --no-start erzeugst du nur die Dateien.
Zusätzlich startet das Skript Dienste für den n8n Assistant, darunter eine Sandbox mit erweiterten Rechten. n8n warnt: Diese Sandbox ist nicht für Produktion gedacht, gehört auf eine eigene Maschine und darf nicht aus dem Internet erreichbar sein. Für einen öffentlichen Server nimmst du deshalb Weg 2.
Starten und stoppen geht so:
docker compose -f ./n8n/compose.yml up -d
docker compose -f ./n8n/compose.yml down
Weg 2: n8n mit Docker Compose auf dem Server
Für Server und Teams beschreibt n8n ein eigenes Compose-Setup. Die Vorlage für compose.yml liegt auf GitHub, die Schritte laut Dokumentation:
- Lege einen Projektordner an:
mkdir n8n && cd n8n. - Lege eine
.envan und trageN8N_VERSIONmit der aktuellen stabilen Version aus den Releases ein. - Ersetze alle Platzhalter
change-me-…durch eigene geheime Werte und halte die Datei aus Git heraus. - Lege
searxng-settings.ymlundcompose.ymlnach der Vorlage an. - Starte mit
docker compose up -dund prüfe mitdocker compose ps, ob alle Dienste laufen. - Prüfe n8n mit
curl -sf http://localhost:5678/healthzund öffne dann den Editor im Browser.
Die .env beginnt so:
N8N_VERSION=change-me-version-number
N8N_SANDBOX_VERSION=change-me-sandbox-version-number
N8N_RUNNERS_AUTH_TOKEN=change-me-runner-auth-token
Stabil war laut Dokumentation am 22.11.2026 die Version 2.48.7. Trag nie latest ein: n8n empfiehlt eine feste Versionsnummer für jeden Prozess.
PostgreSQL statt SQLite
Standardmäßig speichert n8n alles in SQLite. Für Produktion empfiehlt n8n PostgreSQL. Du ergänzt in der .env die Werte POSTGRES_USER, POSTGRES_PASSWORD und POSTGRES_DB, in der compose.yml einen Dienst postgres mit dem Image postgres:18 und eigenem Volume und beim Dienst n8n diese Variablen:
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}
Beim nächsten docker compose up -d legt n8n seine Tabellen in PostgreSQL an. Bestehende SQLite-Daten wandern dabei nicht automatisch mit. Das Volume unter /home/node/.n8n brauchst du trotzdem, denn dort liegt der Schlüssel, mit dem n8n alle Credentials verschlüsselt.
Pflichtwerte für einen öffentlichen Server
- Setze
GENERIC_TIMEZONE=Europe/Berlin, sonst laufen Zeitpläne nach America/New_York. - Setze
N8N_WEBHOOK_URLauf deine HTTPS-Adresse; es ersetzt seit n8n 2.35.0 das alteWEBHOOK_URL. - Setze
N8N_PROXY_HOPS=1, wenn ein Reverse Proxy wie Caddy oder NGINX vor n8n steht. - Erzeuge einen eigenen Schlüssel mit
openssl rand -hex 32und bewahre ihn getrennt vom Server auf.
Den Port 5678 stellst du laut Dokumentation nie direkt ins Internet. TLS endet am Reverse Proxy, n8n bleibt dahinter.
Weg 3: Kurzer Test mit docker run
Die ältere Anleitung mit docker run führt n8n inzwischen als veraltet und verweist auf Compose. Für einen schnellen lokalen Test zeigt sie diesen Befehl:
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Europe/Berlin" \
-e TZ="Europe/Berlin" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-v n8n_data:/home/node/.n8n \
n8nio/n8n
Durch --rm verschwindet der Container beim Beenden, die Daten bleiben im Volume n8n_data. Für einen Dauerbetrieb ist Compose übersichtlicher, weil Version, Variablen und Datenbank in Dateien stehen.
n8n in Docker aktualisieren
n8n veröffentlicht laut Release Notes in den meisten Wochen eine neue Minor-Version. Die Empfehlungen: mindestens einmal im Monat aktualisieren, vorher die Release Notes auf Breaking Changes lesen und ein vollständiges Backup ziehen. Datenbank-Migrationen lassen sich durch Zurücksetzen des Image-Tags nicht rückgängig machen.
Beim One-line setup:
curl -fsSL https://get.n8n.io | sh -s -- --upgrade
Das ändert nur die Zeilen N8N_VERSION und N8N_SANDBOX_VERSION in der .env, Daten und Einstellungen bleiben erhalten. Mit eigenem Compose-Setup trägst du die neue Version in der .env ein und führst im Projektordner aus:
docker compose pull
docker compose down
docker compose up -d
Vor dem Umstieg auf n8n 3.0 zeigt der Migrationsbericht unter Settings, welche Workflows du anpassen musst.
Backup des Docker-Volumes
Ein vollständiges Backup besteht laut n8n aus dem Ordner .n8n und, falls du sie nutzt, der PostgreSQL-Datenbank. In Docker liegt der Ordner im Volume, das unter /home/node/.n8n eingebunden ist. Darin stecken der Verschlüsselungsschlüssel und bei SQLite die gesamte Datenbank. Mit SQLite stoppst du n8n, bevor du das Volume kopierst, sonst kann die Sicherung inkonsistent sein. PostgreSQL sicherst du mit den Werkzeugen der Datenbank.
Workflows und Credentials exportierst du zusätzlich im n8n-Container als JSON:
n8n export:workflow --backup --output=backups/workflows/
n8n export:credentials --backup --output=backups/credentials/
Ein Ordner backups/ im Container übersteht laut Dokumentation das Neuerstellen nicht. Binde dafür einen Ordner des Hosts ein oder kopiere die Dateien heraus. Nutzer, Ausführungshistorie und Variablen fehlen in diesem Export, er ersetzt das Volume-Backup also nicht.
Typische Fehler mit n8n in Docker
- Kein Volume eingebunden: Nach dem Neuerstellen des Containers sind alle Workflows weg.
latestals Version: Ein Neustart holt ungeplant eine neue Version samt Migration.docker compose down -vgetippt: Die Option-vlöscht die Volumes und damit alle Daten.- Sandbox des One-line setup offen im Internet, obwohl n8n davor ausdrücklich warnt.
- Schlüssel nicht gesichert: Ohne ihn stellt ein Backup keine Credentials wieder her.
Läuft n8n, baust du im n8n-Tutorial den ersten Workflow. Was die Cloud im Vergleich kostet, steht unter n8n Kosten. Geprüfte Compose-Dateien tauschen Mitglieder in der KI-Automatisierungs-Community aus.