n8n per CLI: Import/Export, User-Reset

Wer n8n selbst hostet, kommt früher oder später an den Punkt, an dem Workflows gesichert, auf eine andere Instanz übertragen oder ein ausgesperrter Nutzeraccount zurückgesetzt werden müssen. Für alle drei Aufgaben stellt n8n eigene CLI-Befehle bereit, die direkt auf dem Server laufen und ohne funktionierende Weboberfläche auskommen. Dieser Artikel zeigt die wichtigsten Befehle für Export, Import und den Notfall-Passwort-Reset, so wie sie in der offiziellen n8n-Dokumentation beschrieben sind. Stand: Juli 2026.

Workflows exportieren per CLI

Der Befehl export:workflow exportiert Workflows aus der n8n-Datenbank in JSON-Dateien. Ohne zusätzliche Angaben bezieht er sich auf einzelne Workflows, mit den passenden Flags lässt sich der Export aber auf den gesamten Bestand ausweiten oder direkt für ein Backup vorbereiten.

• --all: Exportiert alle Workflows der Instanz statt nur eines einzelnen.
• --id=<ID>: Exportiert nur den Workflow mit der angegebenen ID.
• --output oder -o: Legt die Zieldatei oder, bei mehreren Workflows, das Zielverzeichnis fest.
• --backup: Setzt automatisch --all, --pretty und --separate für eine vollständige, lesbare Sicherung.
• --separate: Schreibt jeden Workflow als eigene Datei, setzt bei --output ein Verzeichnis voraus.
• --pretty: Formatiert die JSON-Ausgabe lesbar statt kompakt.
• --published: Exportiert die veröffentlichte Version eines Workflows statt des aktuellen Entwurfs.
• --version=<VERSION_ID>: Exportiert eine bestimmte historische Version eines Workflows.

Für regelmäßige Sicherungen eignet sich vor allem die Kombination export:workflow --backup --output=backups/latest/, die sich gut als tägliche oder wöchentliche Aufgabe in einem Cronjob einplanen lässt.

Workflows importieren per CLI

Der Gegenpart ist import:workflow. Er liest zuvor exportierte JSON-Dateien ein und schreibt sie in die Datenbank der Zielinstanz zurück, etwa bei einem Serverumzug oder einer Wiederherstellung nach einem Ausfall.

• --input: Pfad zur Eingabedatei oder, zusammen mit --separate, zu einem Verzeichnis mit mehreren Dateien.
• --separate: Importiert alle JSON-Dateien aus einem Verzeichnis statt nur eine einzelne Datei.
• --projectId: Ordnet die importierten Workflows einem bestimmten Projekt zu.
• --userId: Ordnet die importierten Workflows einem bestimmten Nutzer zu.
• --activeState: Steuert, ob importierte Workflows aktiviert werden, standardmäßig false, oder fromJson im Multi-Main-Betrieb.
• --skipMigrationChecks: Überspringt Validierungsprüfungen beim Import.

Wichtig dabei: Workflows mit einer ID, die in der Zieldatenbank bereits existiert, werden beim Import überschrieben, nicht dupliziert. Vor einem Import auf einer produktiven Instanz lohnt sich deshalb immer ein vorheriger Export der bestehenden Workflows als Sicherung.

Notfall: Passwort-Reset per CLI bei Aussperrung

Wenn der Zugriff auf einen n8n-Account fehlt, weil ein Passwort vergessen wurde und kein SMTP-Server für den regulären Reset per E-Mail eingerichtet ist, hilft laut n8n-Dokumentation der Befehl user-management:reset. Er versetzt die Benutzerverwaltung in den Zustand vor der Ersteinrichtung zurück und entfernt dabei alle vorhandenen Benutzerkonten. Beim nächsten Aufruf der Weboberfläche fragt n8n erneut nach der Einrichtung eines neuen Besitzerkontos, ähnlich wie bei einer frischen Installation.

Der Befehl ist bewusst radikal: Er löscht sämtliche Nutzerkonten der Instanz, nicht nur das betroffene. Rollen, Berechtigungen und Zuordnungen zu Projekten müssen danach neu vergeben werden. Workflows, Credentials und die Ausführungshistorie bleiben davon laut Dokumentation unberührt, da der Befehl nur die Benutzerverwaltung zurücksetzt.

Für den engeren Fall, dass jemand nur die Zwei-Faktor-Authentifizierung nicht mehr nutzen kann, etwa weil die Recovery-Codes verloren gegangen sind, reicht der weniger einschneidende Befehl mfa:disable --email=<E-Mail-Adresse>. Er deaktiviert MFA für genau diesen einen Account, sodass sich die Person wieder regulär anmelden und die Zwei-Faktor-Authentifizierung neu einrichten kann.

Weitere CLI-Befehle im Betriebsalltag

• export:credentials und import:credentials: Sichern und übertragen Zugangsdaten; mit --decrypted landen alle sensiblen Werte im Klartext in der Datei, was entsprechend vorsichtig gehandhabt werden sollte.
• audit: Prüft die Instanz auf gängige Sicherheitsprobleme.
• license:info und license:clear: Zeigen die aktuelle Lizenz an oder setzen sie auf den Standardfunktionsumfang zurück.
• n8n --help: Listet alle verfügbaren Befehle der installierten n8n-Version auf, da sich der Funktionsumfang je nach Version unterscheiden kann.

Die CLI-Befehle laufen direkt auf dem Server und setzen entsprechenden Zugriff voraus, etwa per SSH oder docker exec. Wer n8n bei einem Anbieter ohne Shell-Zugriff betreibt, kann sie in der Regel nicht nutzen und ist auf den Support des Anbieters angewiesen. Für Unternehmen, die n8n selbst hosten und im Alltag auf verlässliche Backups und einen dokumentierten Notfallplan angewiesen sind, unterstützt NordFlux beim n8n-Aufbau und -Betrieb mit einer Einrichtung, bei der Sie selbst die Kontrolle über Daten und Zugänge behalten.

Häufige Fragen zu n8n CLI Import/Export

Wie sichere ich alle n8n-Workflows automatisch?

Mit dem Befehl export:workflow --backup --output=<Verzeichnis> lassen sich alle Workflows in lesbarer, aufgeteilter Form sichern. Der Befehl eignet sich gut für einen täglichen Cronjob auf dem Server, ergänzt um eine Kopie des Zielverzeichnisses an einen zweiten Speicherort.

Werden bei user-management:reset auch Workflows und Credentials gelöscht?

Nein. Laut n8n-Dokumentation setzt der Befehl ausschließlich die Benutzerverwaltung zurück und entfernt alle Benutzerkonten. Workflows, Zugangsdaten und die Ausführungshistorie bleiben erhalten, müssen nach dem Reset aber wieder einem neuen Besitzerkonto zugeordnet werden.

Kann ich einzelne Workflows statt der ganzen Instanz exportieren?

Ja. Mit export:workflow --id=<ID> --output=datei.json lässt sich gezielt ein einzelner Workflow exportieren, ohne den restlichen Bestand anzufassen.

Was passiert, wenn eine importierte Workflow-ID bereits existiert?

Der bestehende Workflow mit derselben ID wird beim Import überschrieben, nicht als Kopie angelegt. Deshalb empfiehlt sich vor jedem Import auf einer laufenden Instanz ein aktueller Export als Rückfallebene, siehe die n8n-Dokumentation zur Kommandozeile und die Dokumentation zur Benutzerverwaltung.