n8n Docker: Installation, Updates, Backup

Kurz gesagt

Mit Docker installierst du n8n am schnellsten über den Befehl curl -fsSL https://get.n8n.io | sh, der einen Ordner mit compose.yml und .env anlegt und n8n unter http://localhost:5678 startet. Für einen eigenen Server empfiehlt n8n ein Docker-Compose-Setup mit fester Versionsnummer und PostgreSQL. Ab n8n 3.0 ist Docker der einzige unterstützte Weg, n8n selbst zu betreiben.

Stand: 22. November 2026

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:

  1. Lege einen Projektordner an: mkdir n8n && cd n8n.
  2. Lege eine .env an und trage N8N_VERSION mit der aktuellen stabilen Version aus den Releases ein.
  3. Ersetze alle Platzhalter change-me-… durch eigene geheime Werte und halte die Datei aus Git heraus.
  4. Lege searxng-settings.yml und compose.yml nach der Vorlage an.
  5. Starte mit docker compose up -d und prüfe mit docker compose ps, ob alle Dienste laufen.
  6. Prüfe n8n mit curl -sf http://localhost:5678/healthz und ö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_URL auf deine HTTPS-Adresse; es ersetzt seit n8n 2.35.0 das alte WEBHOOK_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 32 und 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.
  • latest als Version: Ein Neustart holt ungeplant eine neue Version samt Migration.
  • docker compose down -v getippt: Die Option -v lö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.

Wie installiere ich n8n mit Docker?

Mit laufendem Docker und dem Compose-v2-Plugin startest du n8n mit curl -fsSL https://get.n8n.io | sh. Das Skript legt den Ordner n8n mit compose.yml, .env und eigenen Schlüsseln an und startet n8n unter http://localhost:5678.

Welches Docker-Image nutzt n8n?

Die Dokumentation nutzt das Image n8nio/n8n. Setze immer eine feste Version, etwa n8nio/n8n:2.48.7, die laut Dokumentation am 22.11.2026 aktuelle stabile Version, und nicht latest.

Wie aktualisiere ich n8n in Docker?

Beim One-line setup mit curl -fsSL https://get.n8n.io | sh -s -- --upgrade. Mit eigenem Compose-Setup trägst du die neue Version ein und führst docker compose pull, docker compose down und docker compose up -d aus. Vorher ein vollständiges Backup ziehen.

Wo speichert n8n in Docker seine Daten?

Im Volume, das unter /home/node/.n8n eingebunden ist. Dort liegen der Schlüssel für die Credentials und bei SQLite auch die Datenbank. Ohne dieses Volume sind Workflows nach dem Neuerstellen des Containers weg.

Brauche ich für n8n in Docker PostgreSQL?

Für den Start nicht, n8n nutzt standardmäßig SQLite. Für Produktion und mehrere Nutzer empfiehlt n8n PostgreSQL, für den Queue-Modus ist SQLite nicht unterstützt.

Kann ich n8n unter Windows mit Docker installieren?

Ja. Das One-line setup läuft laut n8n unter Windows in WSL mit eingeschalteter WSL2-Integration von Docker Desktop. Git Bash ist dafür nicht geprüft.

Was ist der Unterschied zwischen n8n Docker und n8n self hosted?

Self hosted beschreibt den Betrieb auf eigenem Server mit allen Pflichten. Docker ist der technische Weg dorthin, den n8n empfiehlt und ab Version 3.0 als einzigen unterstützt.

KI-Automatisierungs-Community

Werde Teil der Community

Kostenlos auf Skool, mit über 14.000 Mitgliedern, Kursen und Vorlagen.

Kostenlos beitreten