n8n via CLI : import/export, réinitialisation utilisateur

Quiconque héberge n8n soi-même finit tôt ou tard par devoir sauvegarder des workflows, les transférer vers une autre instance, ou réinitialiser un compte utilisateur verrouillé. Pour ces trois tâches, n8n propose ses propres commandes CLI, qui s'exécutent directement sur le serveur et fonctionnent sans interface web opérationnelle. Cet article présente les commandes les plus importantes pour l'export, l'import et la réinitialisation d'urgence du mot de passe, telles que décrites dans la documentation officielle de n8n. État : juillet 2026.

Exporter des workflows via la CLI

La commande export:workflow exporte les workflows de la base de données n8n vers des fichiers JSON. Sans indication supplémentaire, elle concerne des workflows individuels, mais avec les bons indicateurs, l'export peut être étendu à l'ensemble du parc ou préparé directement pour une sauvegarde.

• --all: Exporte tous les workflows de l'instance au lieu d'un seul.
• --id=<ID>: Exporte uniquement le workflow avec l'ID indiqué.
• --output ou -o: Définit le fichier cible ou, pour plusieurs workflows, le répertoire cible.
• --backup: Active automatiquement --all, --pretty et --separate pour une sauvegarde complète et lisible.
• --separate: Écrit chaque workflow dans son propre fichier, nécessite un répertoire avec --output.
• --pretty: Formate la sortie JSON de manière lisible plutôt que compacte.
• --published: Exporte la version publiée d'un workflow au lieu du brouillon actuel.
• --version=<VERSION_ID>: Exporte une version historique précise d'un workflow.

Pour des sauvegardes régulières, la combinaison export:workflow --backup --output=backups/latest/ convient particulièrement bien et peut facilement être planifiée comme tâche quotidienne ou hebdomadaire dans une tâche cron.

Importer des workflows via la CLI

La contrepartie est import:workflow. Elle lit des fichiers JSON précédemment exportés et les réécrit dans la base de données de l'instance cible, par exemple lors d'un déménagement de serveur ou d'une restauration après une panne.

• --input: Chemin vers le fichier d'entrée ou, associé à --separate, vers un répertoire contenant plusieurs fichiers.
• --separate: Importe tous les fichiers JSON d'un répertoire au lieu d'un seul fichier.
• --projectId: Associe les workflows importés à un projet précis.
• --userId: Associe les workflows importés à un utilisateur précis.
• --activeState: Contrôle si les workflows importés sont activés, false par défaut, ou fromJson en fonctionnement multi-main.
• --skipMigrationChecks: Ignore les vérifications de validation lors de l'import.

Important : les workflows dont l'ID existe déjà dans la base de données cible sont écrasés lors de l'import, pas dupliqués. Avant un import sur une instance de production, il est donc toujours conseillé d'exporter au préalable les workflows existants en guise de sauvegarde.

Urgence : réinitialisation du mot de passe via la CLI en cas de verrouillage

Si l'accès à un compte n8n manque parce qu'un mot de passe a été oublié et qu'aucun serveur SMTP n'est configuré pour la réinitialisation habituelle par e-mail, la commande user-management:reset aide, selon la documentation de n8n. Elle remet la gestion des utilisateurs dans l'état antérieur à la configuration initiale et supprime au passage tous les comptes utilisateurs existants. Lors du prochain accès à l'interface web, n8n redemande la configuration d'un nouveau compte propriétaire, comme lors d'une installation neuve.

La commande est délibérément radicale : elle supprime tous les comptes utilisateurs de l'instance, pas seulement celui concerné. Les rôles, les autorisations et les affectations aux projets doivent ensuite être redéfinis. Les workflows, les identifiants et l'historique d'exécution restent, selon la documentation, inaffectés par cela, car la commande ne réinitialise que la gestion des utilisateurs.

Pour le cas plus restreint où quelqu'un ne peut plus utiliser l'authentification à deux facteurs, par exemple parce que les codes de récupération ont été perdus, la commande moins radicale mfa:disable --email=<adresse-e-mail> suffit. Elle désactive la MFA pour exactement ce compte, afin que la personne puisse se reconnecter normalement et reconfigurer l'authentification à deux facteurs.

Autres commandes CLI pour le quotidien

• export:credentials et import:credentials: Sauvegardent et transfèrent des identifiants ; avec --decrypted, toutes les valeurs sensibles se retrouvent en clair dans le fichier, ce qui doit être manipulé avec la prudence correspondante.
• audit: Vérifie l'instance pour détecter les problèmes de sécurité courants.
• license:info et license:clear: Affichent la licence actuelle ou la réinitialisent au périmètre de fonctionnalités par défaut.
• n8n --help: Liste toutes les commandes disponibles de la version n8n installée, car le périmètre de fonctionnalités peut varier selon la version.

Les commandes CLI s'exécutent directement sur le serveur et nécessitent un accès correspondant, par exemple via SSH ou docker exec. Quiconque héberge n8n chez un fournisseur sans accès shell ne peut généralement pas les utiliser et dépend du support du fournisseur. Pour les entreprises qui hébergent n8n elles-mêmes et dépendent au quotidien de sauvegardes fiables et d'un plan d'urgence documenté, NordFlux accompagne la mise en place et l'exploitation de n8n avec une configuration où vous gardez vous-même le contrôle sur les données et les accès.

Questions fréquentes sur l'import/export CLI de n8n

Comment sauvegarder automatiquement tous les workflows n8n ?

Avec la commande export:workflow --backup --output=<répertoire>, tous les workflows peuvent être sauvegardés sous une forme lisible et séparée. La commande convient bien à une tâche cron quotidienne sur le serveur, complétée par une copie du répertoire cible vers un second emplacement de stockage.

Les workflows et les identifiants sont-ils aussi supprimés avec user-management:reset ?

Non. Selon la documentation de n8n, la commande réinitialise exclusivement la gestion des utilisateurs et supprime tous les comptes utilisateurs. Les workflows, les identifiants et l'historique d'exécution sont conservés, mais doivent être réaffectés à un nouveau compte propriétaire après la réinitialisation.

Puis-je exporter des workflows individuels au lieu de toute l'instance ?

Oui. Avec export:workflow --id=<ID> --output=fichier.json, un seul workflow peut être exporté de manière ciblée, sans toucher au reste du parc.

Que se passe-t-il si un ID de workflow importé existe déjà ?

Le workflow existant portant le même ID est écrasé lors de l'import, et non créé comme copie. Il est donc recommandé de réaliser un export actuel comme solution de repli avant chaque import sur une instance en production, voir la documentation n8n sur la ligne de commande et la documentation sur la gestion des utilisateurs.