Lorixen.
DE

n8n nach Umzug: Zugangsdaten lassen sich nicht entschlüsseln

Kurz gesagt: Wenn eine selbst betriebene n8n-Instanz nach einem Umzug auf einen neuen Server, einem Neuaufbau des Containers oder einer Wiederherstellung aus der Sicherung meldet, dass Zugangsdaten nicht entschlüsselt werden können, fehlt fast immer der ursprüngliche Verschlüsselungsschlüssel. Laut n8n-Dokumentation erzeugt n8n beim ersten Start automatisch einen zufälligen Schlüssel, speichert ihn im Ordner ~/.n8n und verschlüsselt damit alle Zugangsdaten, bevor sie in die Datenbank kommen. Wer nur die Datenbank mitnimmt, nicht aber diesen Ordner oder den Schlüssel, hat zwar Workflows, aber keine nutzbaren Zugangsdaten. Die Lösung: den alten Schlüssel wiederfinden und fest per Umgebungsvariable N8N_ENCRYPTION_KEY setzen.

Warum die Zugangsdaten plötzlich unbrauchbar sind

n8n speichert Verbindungsdaten zu anderen Diensten, etwa Zugänge zu Ihrem Shop, Ihrem Mailprogramm oder Ihrer Buchhaltungssoftware, verschlüsselt in der Datenbank. Der Schlüssel dafür liegt laut Dokumentation nicht in der Datenbank, sondern in einer Einstellungsdatei im Ordner ~/.n8n. Bei Docker-Installationen ist das der Ordner /home/node/.n8n im Container.

Startet n8n ohne diesen Ordner und ohne gesetzten Schlüssel, erzeugt es einen neuen, zufälligen Schlüssel. Die alten Zugangsdaten in der Datenbank wurden aber mit dem alten Schlüssel verschlüsselt. Der neue passt nicht, und n8n kann sie nicht lesen. Die Workflows sind da, laufen aber ins Leere.

Typische Auslöser

  • Umzug auf einen neuen Server: Die Datenbank wurde kopiert, der Ordner mit der Einstellungsdatei nicht.
  • Container neu aufgebaut: Der Ordner /home/node/.n8n war nicht als dauerhaftes Volume eingebunden. Laut n8n-Dokumentation zur Docker-Installation sollte genau dieser Ordner auf ein Volume gelegt werden, damit Daten Neustarts überstehen. Die Dokumentation weist ausdrücklich darauf hin, dass der Ordner auch bei externer Datenbank wichtige Daten wie Verschlüsselungsschlüssel enthält.
  • Warteschlangen-Betrieb mit mehreren Workern: Laut Dokumentation muss im Queue-Modus allen Workern derselbe Schlüssel per Umgebungsvariable mitgegeben werden. Fehlt er bei einem Worker, scheitern Läufe nur dort.
  • Wiederherstellung aus einer Sicherung, die nur die Datenbank enthielt.

Schritt 1: Nichts überschreiben

Bevor Sie irgendetwas neu anlegen, sichern Sie den aktuellen Zustand: Datenbank und, falls vorhanden, den neuen ~/.n8n-Ordner. Legen Sie Zugangsdaten nicht vorschnell neu an. Solange der alte Schlüssel auffindbar ist, lassen sich die bestehenden Zugangsdaten retten.

Schritt 2: Den alten Schlüssel suchen

Der Schlüssel steht in der Einstellungsdatei im alten ~/.n8n-Ordner. Suchen Sie an diesen Stellen:

  • auf dem alten Server, falls er noch läuft oder als Abbild vorhanden ist,
  • im alten Docker-Volume, falls es noch existiert,
  • in Ihrer Dateisicherung des alten Servers,
  • in Ihrer Passwortverwaltung oder Dokumentation, falls der Schlüssel dort beim ersten Einrichten notiert wurde,
  • in der alten Konfiguration, etwa einer Compose-Datei oder einer Umgebungsdatei, falls der Schlüssel schon damals per Variable gesetzt war.

Behandeln Sie den Schlüssel wie ein Passwort und geben Sie ihn nicht per E-Mail oder Chat weiter. Wer ihn zusammen mit der Datenbank hat, kann alle gespeicherten Zugangsdaten lesen.

Schritt 3: Den Schlüssel fest setzen

Laut Dokumentation können Sie den Schlüssel über die Umgebungsvariable N8N_ENCRYPTION_KEY vorgeben. n8n verwendet dann diesen Schlüssel, statt einen neuen zu erzeugen. Setzen Sie die Variable auf den Wert des alten Schlüssels und starten Sie n8n neu.

Wichtig: Laut Dokumentation greift die Variable, wenn der Schlüssel noch nicht in der Einstellungsdatei steht. Hat n8n auf dem neuen Server bereits einen eigenen Schlüssel erzeugt, prüfen Sie die neue Einstellungsdatei und gleichen Sie sie mit dem alten Wert ab, damit beide nicht widersprüchlich sind. Lassen Sie diesen Schritt im Zweifel von der Person durchführen, die den Server betreut.

Schritt 4: Prüfen

Öffnen Sie nach dem Neustart einige Zugangsdaten in n8n und testen Sie die Verbindung. Lassen Sie danach einen unkritischen Workflow manuell laufen. Im Queue-Modus prüfen Sie, ob alle Worker denselben Schlüssel haben.

Woran Sie das Problem erkennen

Nicht immer ist die Ursache sofort klar. Typische Anzeichen sind:

  • Workflows schlagen bei jedem Knoten fehl, der eine gespeicherte Verbindung nutzt, während Knoten ohne Zugangsdaten weiterlaufen.
  • Beim Öffnen gespeicherter Zugangsdaten erscheint ein Fehler statt der gewohnten Eingabemaske.
  • Der Fehler tritt bei allen Diensten gleichzeitig auf, nicht nur bei einem einzelnen. Ein abgelaufenes Token betrifft dagegen meist nur eine Verbindung.

Wenn der Schlüssel verloren ist

Ist der alte Schlüssel nirgends mehr zu finden, lassen sich die verschlüsselten Zugangsdaten nicht wiederherstellen. Dann bleibt nur, sie neu anzulegen:

  1. Erstellen Sie eine Liste aller Zugangsdaten, die in Workflows verwendet werden.
  2. Legen Sie sie mit neuen Tokens oder Passwörtern neu an. Nutzen Sie die Gelegenheit, alte Zugänge bei den jeweiligen Diensten zu widerrufen.
  3. Ordnen Sie die neuen Zugangsdaten in den Workflows zu und testen Sie jeden Workflow.

Das ist mühsam, aber auch eine Chance, nicht mehr benötigte Verbindungen aufzuräumen.

So vermeiden Sie das künftig

  • Schlüssel von Anfang an fest setzen: Setzen Sie N8N_ENCRYPTION_KEY bei jeder Installation bewusst und notieren Sie den Wert in Ihrer Passwortverwaltung.
  • Volume einbinden: Legen Sie /home/node/.n8n bei Docker immer auf ein dauerhaftes Volume.
  • Sicherungen vollständig machen: Sichern Sie Datenbank und ~/.n8n-Ordner gemeinsam. Laut Dokumentation bietet n8n zudem Kommandozeilenbefehle zum Export von Workflows und Zugangsdaten.
  • Umzug testen: Spielen Sie einen Umzug zuerst auf einer Testinstanz durch.

Ein Hinweis zur Export-Funktion: Laut Dokumentation gibt es eine Option, Zugangsdaten unverschlüsselt zu exportieren. Eine solche Datei enthält alle Passwörter im Klartext. Nutzen Sie sie nur, wenn es nicht anders geht, und löschen Sie sie danach sicher.

Ein Beispiel zur Veranschaulichung

Frei erfunden: Ein Hamburger Onlinehändler zieht seine n8n-Instanz auf einen neuen Server um. Der Dienstleister kopiert die Datenbank, startet n8n per Docker und meldet Erfolg. Am nächsten Morgen laufen keine Bestellabgleiche, weil alle Zugangsdaten unlesbar sind. Der alte Server ist noch nicht gekündigt. Im alten Volume findet sich die Einstellungsdatei mit dem Schlüssel. Der Dienstleister setzt ihn als Umgebungsvariable, startet neu, und die Workflows laufen wieder. Der Schlüssel liegt seither in der Passwortverwaltung des Unternehmens.

Häufige Fragen

Sind meine Workflows verloren?

Nein. Workflows liegen in der Datenbank und sind nicht von diesem Schlüssel abhängig. Betroffen sind die gespeicherten Zugangsdaten.

Kann ich einfach einen neuen Schlüssel setzen?

Ein neuer Schlüssel macht die alten Zugangsdaten nicht lesbar. Er hilft nur, wenn Sie alle Zugangsdaten danach neu anlegen.

Muss jeder Worker den Schlüssel kennen?

Ja. Laut Dokumentation muss im Queue-Modus die Variable für alle Worker gesetzt sein.

Wenn Ihre n8n-Instanz nach einem Umzug nicht mehr an ihre Zugangsdaten kommt, helfen wir beim Wiederherstellen und Absichern: n8n-Umzug besprechen.

Quellen

WhatsAppTermin buchen