Comment migrer une configuration n8n entre deux VPS

Objectif

Ce guide vous explique comment transférer une configuration n8n existante vers un VPS OVHcloud, ou depuis un VPS OVHcloud vers une autre instance. Vous pouvez choisir soit la méthode d'export/import via les commandes CLI de n8n, soit la sauvegarde/restauration du dossier .n8n.

Prérequis

• Disposer de deux VPS fonctionnels (OVHcloud ou autres)
• Disposer d'un accès administrateur (sudo) via SSH à votre serveur

En pratique

Sommaire

• Méthode 1 : Exporter et importer via la CLI n8n
• Méthode 2 : Sauvegarde et restauration du dossier .n8n
• Points d'attention
• Conclusion

Méthode 1 - Exporter et importer via la CLI n8n

n8n fournit des commandes pour exporter et importer vos workflows et credentials.

Selon votre installation, vous avez deux possibilités :

• n8n installé en mode CLI (npm ou binaire) : tapez directement n8n export:... depuis votre VPS.
• n8n installé via Docker (cas OVHcloud avec l’image n8nio/n8n) : exécutez les commandes à l’intérieur du conteneur avec docker exec.

Étape 1 - Connectez-vous au VPS source

Ouvrez un terminal et connectez-vous en SSH à votre VPS où n8n est installé :

ssh <user>@<IP_VPS_SOURCE>

Étape 2 - Exportez les workflows

Cas A - Installation en CLI natif

Cas B - Installation via Docker

Exécutez la commande suivante pour exporter tous les workflows dans un fichier :

n8n export:workflow --all --output=workflows.json

Identifiez le nom de votre conteneur n8n (par défaut n8n) :

docker ps

Exécutez la commande suivante pour générer le fichier à l’intérieur du conteneur :

docker exec -it n8n n8n export:workflow --all --output=/home/node/workflows.json

Exemple de sortie :

Sortez le fichier du conteneur pour le placer dans le système de fichiers du VPS source :

docker cp n8n:/home/node/workflows.json /root/workflows.json

Exemple de sortie :

Étape 3 - Exportez les credentials

Cas A - Installation en CLI natif

Cas B - Installation via Docker

Exécutez la commande suivante pour exporter tous les credentials déchiffrés vers un fichier JSON :

n8n export:credentials --all --decrypted --output=credentials.json

Exécutez cette commande dans le conteneur n8n pour générer le fichier des credentials déchiffrés :

docker exec -it n8n n8n export:credentials --all --decrypted --output=/home/node/credentials.json

Exemple de sortie :

Warning

Utilisez l’option --decrypted si vous migrez vers une autre instance pour éviter les erreurs de chiffrement. Manipulez ce fichier avec précaution car il contient des données sensibles.

Copiez ce fichier vers le système de fichiers du VPS source :

docker cp n8n:/home/node/credentials.json /root/credentials.json

Exemple de sortie :

Étape 4 - Transférez les fichiers exportés

Copiez les fichiers générés (workflows.json et credentials.json) vers votre VPS cible :

scp workflows.json credentials.json <user>@<IP_VPS_CIBLE>:/root/

Étape 5 - Importez les workflows

Connectez-vous en SSH à votre VPS cible :

ssh <user>@<IP_VPS_CIBLE>

n8n import:workflow --input=workflows.json

docker exec -it n8n n8n import:workflow --input=/home/node/workflows.json

Étape 6 - Importez les credentials

n8n import:credentials --input=credentials.json

docker exec -it n8n n8n import:credentials --input=/home/node/credentials.json

Méthode 2 - Sauvegarde et restauration du dossier .n8n

Cette méthode permet de transférer l’intégralité de la configuration (workflows, credentials et paramètres) entre deux instances.

Où se trouve le dossier .n8n ?

• Installation CLI (npm ou binaire) : le dossier se trouve généralement dans le répertoire personnel de l’utilisateur qui exécute n8n, par exemple /root/.n8n ou /home/<user>/.n8n.
• Installation Docker : le dossier se trouve dans le conteneur à l’emplacement /home/node/.n8n. Dans la plupart des configurations Docker Compose, il est monté en volume nommé n8n_data ou dans un dossier du VPS (ex : /root/n8n_data:/home/node/.n8n).

Vérifiez son emplacement avec :

docker exec -it n8n ls -lah /home/node/.n8n
docker inspect n8n | grep -A 5 Mounts

Étape 1 - Sauvegardez le dossier .n8n

tar czvf n8n-backup.tar.gz /root/.n8n

docker exec n8n tar czvf - /home/node/.n8n > n8n-backup.tar.gz

Étape 2 - Transférez l’archive vers le VPS cible

Envoyez le fichier vers votre VPS cible :

scp n8n-backup.tar.gz <user>@<IP_VPS_CIBLE>:/root/

Connectez-vous en SSH à votre VPS cible :

ssh <user>@<IP_VPS_CIBLE>

Étape 3 - Restaurez l’archive sur le VPS cible

Sur votre VPS cible, restaurez l’archive dans le dossier .n8n du conteneur :

docker exec -i n8n sh -c 'tar xzvf - -C /home/node/.n8n' < n8n-backup.tar.gz

Étape 4 - Redémarrez n8n

Relancez n8n :

docker start n8n

Points d'attention

Après la migration, si le domaine ou le sous-domaine change (par exemple n8n.mydomain.com → n8n.ovh.net), mettez à jour :

• La variable N8N_HOST dans votre fichier docker-compose.yml.
• Votre zone DNS pour que le sous-domaine pointe vers l’adresse IP du nouveau VPS.

Pour en savoir plus, consultez notre guide Modifier une zone DNS OVHcloud

Conclusion

Vous disposez désormais de deux méthodes pour migrer vos workflows et credentials n8n vers un VPS OVHcloud (ou depuis OVHcloud vers un autre environnement) :

• Export/Import via CLI : simple et sélectif.
• Sauvegarde .n8n : complet, idéal pour une migration totale.

Pour plus d’informations, référez-vous à la documentation officielle n8n.

Aller plus loin

Comment installer n8n sur un VPS OVHcloud

Échangez avec notre communauté d'utilisateurs.