n8n selbst gehostet mit Docker: was der Produktivbetrieb verlangt

Ein selbst gehostetes n8n mit Docker zu installieren, dauert ein paar Befehle, die die Dokumentation von n8n zu Docker Compose Schritt für Schritt angibt. Sie beginnt allerdings mit einer Warnung: Der Hersteller empfiehlt Self-Hosting erfahrenen Nutzern, denn ein Fehler kann Daten, Sicherheit oder Ausfallzeit kosten. Zwischen der Instanz, die startet, und der, der man echte Prozesse anvertraut, bleiben Entscheidungen zu treffen.

Mehrere davon haben wir für unseren eigenen Server getroffen, der ein Dutzend Dienste in Docker-Containern hinter einem Traefik-Router betreibt. n8n führt dort unsere produktiven Workflows aus, darunter einen Agenten zur Erfassung von Ausgaben über Telegram und den, der jeder neuen Immobilie im CRM von Palmora Property eine interne Kennung zuweist, einem Immobilienportal, das wir betreiben. Dieser Leitfaden verbindet die Dokumentation des Herstellers mit diesem Betrieb.

Kurz gesagt

• Docker Compose hinter einem HTTPS-Proxy, mit fixierter Version und versionierter Konfigurationsdatei, ohne die Secrets.
• Der Verschlüsselungsschlüssel schützt Ihre Zugangsdaten: Legen Sie ihn vor dem ersten Start fest und bewahren Sie eine Kopie außerhalb des Servers auf.
• SQLite genügt zum Ausprobieren; wir empfehlen PostgreSQL ab den ersten produktiven Prozessen.
• Die Telemetrie ist standardmäßig aktiv und wird über Umgebungsvariablen abgeschaltet, nicht in der Oberfläche.
• Beim Self-Hosting liegt die DSGVO bei Ihnen: Der Hersteller ist für die Daten Ihrer Workflows weder Verantwortlicher noch Auftragsverarbeiter.

Docker oder Docker Compose?

Die Seite der Dokumentation, die n8n nur mit Docker installiert, ist vom Hersteller selbst als veraltet markiert, der auf Docker Compose verweist: Eine einzige Datei beschreibt die Container, ihre Volumes und Variablen, und sie wird wie Code versioniert.

Das Modell des Herstellers setzt zwei Container ein, n8n und einen Proxy, und legt die Daten in einem Volume ab:

Zwei Ergänzungen zum Modell: Halten Sie die Secrets (Datenbankpasswort, Verschlüsselungsschlüssel) in einer Umgebungsdatei, die nicht ins Repository wandert, und ersetzen Sie das Image, das der neuesten Version folgt, durch eine genaue Version.

SQLite oder PostgreSQL?

Ohne Einstellung speichert n8n seine Workflows, Zugangsdaten und den Ausführungsverlauf in einer SQLite-Datenbank, einer Datei in seinem Volume. Die Dokumentation der Docker-Installation erklärt den Wechsel zu PostgreSQL: die Variable DB_TYPE=postgresdb und die Variablen DB_POSTGRESDB_* (Host, Datenbank, Benutzer, Passwort). Sie empfiehlt, den Ordner /home/node/.n8n auch mit PostgreSQL zu behalten: Er enthält weitere wichtige Daten, darunter die Verschlüsselungsschlüssel und die Protokolle der Instanz.

SQLite genügt, um n8n auf einer einzelnen Instanz auszuprobieren. Sobald sich die Arbeit auf mehrere Prozesse verteilt, rät die Dokumentation des Queue-Modus von SQLite ab und unterstützt kein verteiltes System, das darauf beruht. Wir empfehlen PostgreSQL, sobald eine Instanz produktive Prozesse trägt: Die Datenbank wird mit ihren eigenen Werkzeugen gesichert, wie wir in unserem Leitfaden zur Sicherung eines eigenen Servers beschreiben, und der Wechsel in den Queue-Modus, falls er eines Tages kommt, verlangt keinen Datenbankwechsel.

Der Verschlüsselungsschlüssel, das Secret, das man nie verlieren darf

n8n verschlüsselt die Zugangsdaten, die Sie ihm anvertrauen (API-Schlüssel, Passwörter verbundener Dienste), bevor es sie in der Datenbank speichert. Laut der Dokumentation zum Verschlüsselungsschlüssel erzeugt es beim ersten Start einen zufälligen Schlüssel und legt ihn in seinem Datenordner ab; einen eigenen kann man mit der Variable N8N_ENCRYPTION_KEY festlegen, solange der Schlüssel noch nicht in der Einstellungsdatei steht. Legen Sie ihn also vor dem ersten Start fest und bewahren Sie eine Kopie in einem Secret-Manager auf, außerhalb des Servers.

Welche Variablen vor dem Produktivbetrieb einstellen?

Das Modell des Herstellers regelt einen Teil davon. Hier die Variablen, die vor dem ersten echten Prozess zu prüfen sind, nach der Dokumentation von n8n zu Webhooks hinter einem Proxy, der Zeitzone und den Ausführungsdaten.

Wie aktualisiert man n8n, ohne den Produktivbetrieb zu gefährden?

Laut seiner Docker-Compose-Dokumentation veröffentlicht n8n in den meisten Wochen eine neue Minor-Version: Die stabile dient dem Produktivbetrieb, die Beta ist neuer und kann instabil sein. Ein Image, das der neuesten Version folgt, kann Sie auf einen Schlag um mehrere Versionen anheben, ohne dass Sie es entschieden haben. Wir empfehlen vier Schritte:

1. 01Fixieren Sie eine genaue Version.

   Die Compose-Datei legt die Versionsnummer fest, statt der neuesten zu folgen.

2. 02Lesen Sie die Versionshinweise.

   Der Wechsel auf eine Major-Version verlangt die meiste Aufmerksamkeit: Version 2.0 hat zum Beispiel den Knoten Execute Command standardmäßig deaktiviert.

3. 03Sichern Sie die Datenbank und prüfen Sie den Schlüssel.

   Eine Sicherung direkt vor dem Update erlaubt es, zurückzugehen.

4. 04Aktualisieren, dann prüfen.

   Die Dokumentation reiht docker compose pull, docker compose down und dann docker compose up -d aneinander. Öffnen Sie danach einen kritischen Workflow und beobachten Sie seine nächste Ausführung.

Und bei dieser Gelegenheit niemals eine globale Bereinigung des Servers: Ein Befehl dieser Art hat bei uns im Juli 2026 die Container von zehn Diensten gelöscht.

Sollte man in den Queue-Modus wechseln?

Der Queue-Modus verteilt die Ausführungen über eine von Redis gehaltene Warteschlange auf mehrere Worker. Laut seiner Dokumentation verlangt er EXECUTIONS_MODE=queue und denselben Verschlüsselungsschlüssel auf jedem Prozess und, wenn Ihre Workflows Dateien aufbewahren müssen, einen externen Speicher vom Typ S3: Dieser Modus unterstützt ihre Speicherung auf der Festplatte des Servers nicht.

Beginnen Sie mit einer gut eingestellten Einzelinstanz und teilen Sie erst auf, nachdem Sie gemessen haben, was bremst.

Was gehört nicht in n8n?

Mit Docker führt der Knoten Execute Command seine Befehle im Container von n8n aus, nicht auf dem Server, und er ist seit Version 2.0 standardmäßig deaktiviert. Der Container sieht nur die Ordner, die man ihm eingehängt hat. Ihm Zugriff auf den Server zu geben, etwa auf die Docker-Engine, würde diese Macht jedem Workflow geben und jeder Person, die einen ändern kann.

Daraus folgt die Regel, die wir empfehlen: Aufgaben, die die Werkzeuge des Servers brauchen (Sicherungen, Bereinigungen, Skripte, die eine Website veröffentlichen), gehören in den Planer des Servers oder in die Continuous Integration, nicht in n8n.

n8n behält, was es am besten kann: Dienste über ihre APIs verbinden.

Die Telemetrie: was zum Hersteller geht

Laut seiner Seite zum Datenschutz erhält n8n nie die Daten Ihrer Workflows, wenn Sie es selbst hosten. Seine Telemetrie, standardmäßig aktiv und als pseudonym dargestellt (an einen Code gebunden, nicht an Ihren Namen), umfasst insbesondere eine gekürzte IP-Adresse, die Hauptdomain der Adressen, die von HTTP-Request-Knoten und Webhook-Aufrufen angesprochen werden, ohne Subdomain und Pfad, sowie Informationen zu Instanz, Nutzung und Fehlern. Die Seite zur Telemetrie ergänzt die Zahl der Ausführungen und ein Signal der Instanz alle sechs Stunden.

Einen Schalter in der Oberfläche gibt es nicht: Alles wird über Umgebungsvariablen abgeschaltet, zusammengefasst in der Anleitung zum Isolieren einer Instanz. Mit einer kostenpflichtigen Lizenz meldet die Instanz weiterhin ihre Nutzungsvolumen und ihre Lizenzkennung, und das lässt sich nicht deaktivieren. Wer dieser Anleitung folgt, schaltet auch die Ankündigung neuer Versionen in der Oberfläche ab: Die Versionshinweise zu verfolgen, wird Ihre Aufgabe.

Die DSGVO liegt bei Ihnen

Die Seite zum Datenschutz sagt es ohne Umschweife:

Dieselbe Seite macht eine Ausnahme für die Telemetrie: n8n ist Verantwortlicher für die Nutzungs- und Diagnosedaten, die Ihre Instanz ihm sendet.

Vier Punkte verlangen daher eine Entscheidung von Ihnen.

• Der Ausführungsverlauf bewahrt personenbezogene Daten auf. Um die einer Person zu löschen, gibt n8n an, die sie betreffenden Ausführungen zu löschen, und empfiehlt, deren Bereinigung einzustellen; unser Leitfaden zur Überwachung von n8n im Produktivbetrieb beschreibt, was es aufbewahrt und wie lange.
• Das Schwärzen von Ausführungsdaten ist beim Self-Hosting der Enterprise-Edition vorbehalten, laut seiner Dokumentation: Ohne sie bleibt der Verlauf für alle lesbar, die Zugriff haben.
• Jeder aufgerufene Dienst erhält Daten. Eine KI-Modell-API oder ein E-Mail-Werkzeug ist ein weiterer Auftragsverarbeiter, mit eigenem Vertrag.
• Das Verzeichnis und die Verträge. Die Verarbeitung gehört in Ihr Verzeichnis von Verarbeitungstätigkeiten, und der Hoster Ihres Servers ist ein Auftragsverarbeiter, der durch einen Vertrag nach Artikel 28 DSGVO zu binden ist. Die CNIL, die französische Datenschutzbehörde, rät in ihrem Merkblatt zur Auftragsverarbeitung davon ab, Cloud-Dienste ohne Garantie über den tatsächlichen geografischen Standort der Daten zu nutzen.

Dieser Leitfaden sagt, wo man hinschauen muss; er ersetzt keine rechtliche Beratung zu Ihrer Verarbeitung.

Die ehrlichen Grenzen

• Self-Hosting verschiebt die Kosten, es beseitigt sie nicht: der Server, die Sicherungen, häufige Updates und jemand, der überwacht.
• Keine Verfügbarkeitsgarantie eines Herstellers: Nachts warnt Ihre Alarmierung, oder niemand.
• Die Community-Edition enthält weder SSO noch das Teilen von Workflows: Wir beschreiben, was die Lizenz von n8n erlaubt.

Womit beginnen

Beginnen Sie mit einer Bestandsaufnahme: die Prozesse, die n8n tragen wird, die Daten, die sie berühren, und wer die Warnungen erhält. Dann, in dieser Reihenfolge: die versionierte Compose-Datei und der Schlüssel außerhalb des Servers, die Datenbank, die Variablen, die Entscheidung zur Telemetrie und eine erste getestete Wiederherstellung vor dem ersten produktiven Prozess.

Wenn n8n nur eines der zu installierenden Werkzeuge ist, setzt unser Leitfaden zum gemeinsamen Infrastrukturfundament Ihrer Projekte den Rahmen; wenn Sie noch zögern, es selbst zu hosten, lesen Sie unseren Vergleich von n8n, Make und Zapier. Für einen installierten, gesicherten und überwachten Server installiert unser Ausstieg aus dem SaaS bis zu fünf Werkzeuge, mit Managed Service als Option; wenn die Prozesse selbst gebaut werden müssen, ist es unser Angebot zur Automatisierung.

Häufige Fragen

Quellen

1. Dokumentation von n8n zu Docker Compose (neuer Tab)docs.n8n.io
2. N8n nur mit Docker installiert (neuer Tab)docs.n8n.io
3. Die Dokumentation des Queue-Modus (neuer Tab)docs.n8n.io
4. Der Dokumentation zum Verschlüsselungsschlüssel (neuer Tab)docs.n8n.io
5. Webhooks hinter einem Proxy (neuer Tab)docs.n8n.io
6. Der Zeitzone (neuer Tab)docs.n8n.io
7. Den Ausführungsdaten (neuer Tab)docs.n8n.io
8. Der Knoten Execute Command (neuer Tab)docs.n8n.io
9. Seiner Seite zum Datenschutz (neuer Tab)docs.n8n.io
10. Die Seite zur Telemetrie (neuer Tab)docs.n8n.io
11. Der Anleitung zum Isolieren einer Instanz (neuer Tab)docs.n8n.io
12. Seiner Dokumentation (neuer Tab)docs.n8n.io
13. Verzeichnis von Verarbeitungstätigkeiten (neuer Tab)cnil.fr
14. Ihrem Merkblatt zur Auftragsverarbeitung (neuer Tab)cnil.fr