n8n updaten ohne Datenverlust: Versionspinning, Backup, Rollback

n8n lässt sich ohne Datenverlust aktualisieren, wenn Sie vor jedem Update ein vollständiges Backup der Datenbank und des Encryption Keys anlegen, die Zielversion bewusst pinnen statt automatisch auf „latest" zu aktualisieren, und die neue Version zuerst in einer Testumgebung prüfen. Die offizielle n8n-Dokumentation empfiehlt, regelmäßig zu aktualisieren, mindestens einmal im Monat, und keine mehreren Hauptversionen zu überspringen, weil sonst das Risiko eines störenden Updates steigt. Verschwundene Workflows nach einem Update sind in der Praxis fast immer kein echter Datenverlust, sondern ein Konfigurationsfehler bei Docker-Volumes oder Benutzerrechten. Stand: Juli 2026.

Warum sollten Sie n8n nicht einfach auf die jeweils neueste Version aktualisieren?

Ein unkontrolliertes Update auf die jeweils neueste Version ist die häufigste Ursache für böse Überraschungen. n8n selbst empfiehlt in der offiziellen Update-Dokumentation, regelmäßig zu aktualisieren, um nicht mehrere Versionen auf einmal überspringen zu müssen, vor jedem Update die Release Notes auf Breaking Changes zu prüfen und die neue Version zuerst in einer separaten Testumgebung laufen zu lassen, bevor sie produktiv geht. Wer stattdessen monatelang keine Updates einspielt und dann in einem Rutsch mehrere Hauptversionen springt, erhöht das Risiko, dass veraltete Nodes, geänderte Datenstrukturen oder entfernte Funktionen gleichzeitig zuschlagen. Details zum empfohlenen Vorgehen finden Sie in der Update-Dokumentation von n8n.

Wie pinnen Sie die n8n-Version bei Docker und npm?

Versionspinning bedeutet, dass Sie eine konkrete Versionsnummer statt eines beweglichen Tags wie „latest" einsetzen, damit ein Neustart oder Redeploy nicht ungewollt eine neuere Version zieht. Bei Docker ziehen Sie ein festes Image-Tag, zum Beispiel mit docker pull docker.n8n.io/n8nio/n8n gefolgt von der gewünschten Versionsnummer als Tag, und tragen dieselbe Nummer in Ihrem Compose-File ein, wie es die Docker-Installationsanleitung beschreibt. Bei einer npm-Installation installieren Sie eine konkrete Version mit npm install -g n8n gefolgt von der Versionsnummer, laut npm-Installationsanleitung. Den next-Tag für Beta-Versionen sollten Sie laut Dokumentation ausdrücklich nicht produktiv einsetzen. Erst wenn die gepinnte neue Version in der Testumgebung sauber läuft, aktualisieren Sie die Produktivinstanz auf dieselbe Nummer.

Was müssen Sie vor dem Update sichern?

Vor jedem Update gehören zwei Dinge ins Backup: die Datenbank mit allen Workflows und Ausführungen sowie der Encryption Key. n8n verschlüsselt gespeicherte Zugangsdaten mit einem Schlüssel, der entweder automatisch beim ersten Start im Verzeichnis .n8n abgelegt oder über die Umgebungsvariable N8N_ENCRYPTION_KEY gesetzt wird, wie in der Dokumentation zum Encryption Key beschrieben. Geht dieser Schlüssel verloren, zum Beispiel weil ein Docker-Container ohne persistiertes Volume neu gebaut wird, lassen sich gespeicherte Credentials nicht mehr entschlüsseln, selbst wenn die Datenbank an sich intakt ist. Im Queue-Modus muss laut Dokumentation außerdem jeder Worker denselben Encryption Key erhalten, sonst verschlüsseln und entschlüsseln Haupt- und Worker-Prozesse mit unterschiedlichen Schlüsseln. Wer zusätzlich die Encryption-Key-Rotation nutzt, sollte laut der Dokumentation zur Schlüsselrotation vorher zwingend ein vollständiges Datenbank-Backup anlegen, denn die Aktivierung ist laut n8n ein einseitiger Schritt ohne Rollback-Pfad.

Was tun, wenn nach einem Update Workflows fehlen?

Fehlende Workflows nach einem Update sind in aller Regel kein echter Datenverlust, sondern ein Zugriffsproblem. In n8n-Community-Foren berichten Nutzer wiederholt von scheinbar verschwundenen Workflows nach einem Update, wobei sich die Ursache meist als falsch gemountetes Docker-Volume oder als fehlerhafte Benutzerrechte im Container herausstellt: Die Datenbank existiert weiter, der n8n-Prozess kann sie nach dem Neustart nur nicht mehr finden oder lesen. Prüfen Sie deshalb zuerst, ob Ihr Datenverzeichnis korrekt als Volume gemountet ist und ob der Container mit demselben Benutzer läuft wie vor dem Update. Mit einem aktuellen Datenbank-Backup lässt sich im Ernstfall der Stand vor dem Update wiederherstellen, was faktisch Ihr Rollback ist, denn n8n bietet keinen eingebauten Ein-Klick-Rollback auf eine ältere Version. Wer diesen Prozess nicht selbst absichern möchte, kann ihn im Rahmen einer n8n-Beratung und -Betreuung an NordFlux auslagern.

Häufige Fragen zu n8n-Updates

Wie oft sollte ich n8n aktualisieren?

n8n empfiehlt in der offiziellen Dokumentation, mindestens einmal im Monat zu aktualisieren. Das verhindert, dass sich mehrere Hauptversionen aufstauen und ein einzelnes Update dadurch mehrere Breaking Changes gleichzeitig mitbringt. Kleinere, häufigere Updates sind leichter zu testen und im Fehlerfall leichter einzugrenzen.

Reicht ein Datenbank-Backup allein, um vor Datenverlust zu schützen?

Nein, ohne den passenden Encryption Key bleibt ein Datenbank-Backup für gespeicherte Zugangsdaten wertlos. n8n verschlüsselt Credentials mit diesem Schlüssel, und ohne ihn lassen sich die verschlüsselten Werte aus der Datenbank nicht mehr lesbar machen. Sichern Sie Datenbank und Encryption Key deshalb immer gemeinsam.

Gibt es einen offiziellen Rollback-Mechanismus in n8n?

Nein, n8n bietet keinen eingebauten Ein-Klick-Rollback auf eine vorherige Version. Der praktische Rollback-Weg besteht darin, das gepinnte alte Image beziehungsweise die alte npm-Version erneut zu installieren und die zuvor gesicherte Datenbank samt Encryption Key wiederherzustellen.

Was ist der Unterschied zwischen dem Encryption Key und der Encryption-Key-Rotation?

Der Encryption Key, gesetzt über N8N_ENCRYPTION_KEY, ist der eine feste Hauptschlüssel, mit dem n8n Zugangsdaten verschlüsselt. Die Encryption-Key-Rotation ist eine separate, optionale Funktion für Instanzen, die den inneren Datenschlüssel periodisch austauschen wollen, wobei laut Dokumentation vorher zwingend ein vollständiges Backup nötig ist, weil die Aktivierung nicht rückgängig gemacht werden kann.