Mettre à jour n8n sur un VPS (Hostinger ou autre) sans rien perdre

Ton n8n tourne sur un VPS (Hostinger ou autre) et tu veux le mettre à jour sans perdre tes workflows.

La réponse courte : sauvegarde d’abord, puis trois commandes. Dans le dossier de ton fichier Docker Compose, tu lances docker compose pull puis docker compose up -d, et tu vérifies la version. Sur Hostinger, un bouton Update fait la même chose. Sur n8n Cloud, tu n’as rien à lancer.

À la fin de ce tutoriel, ton instance sera à jour, tu sauras vérifier la version installée et revenir en arrière si la mise à jour casse un workflow.

Vérifié le 6 octobre 2026 sur la documentation officielle de n8n (docs.n8n.io) et l’aide de Hostinger.

Comment exécuter n8n avec un VPS ?

Petit rappel pour situer ce tuto. Sur un VPS, n8n tourne presque toujours dans Docker, piloté par un fichier docker-compose.yml. C’est ce que fait le modèle n8n de Hostinger (fichier dans /docker/n8n) et c’est la méthode que recommande la documentation de n8n. Tes workflows, tes identifiants et la clé de chiffrement vivent dans un volume Docker (le dossier /home/node/.n8n du conteneur), et dans une base PostgreSQL si tu en utilises une.

Mettre à jour n8n, c’est donc remplacer l’image Docker par une plus récente en gardant ce volume. Si tu n’as pas encore installé n8n sur ton VPS, commence par notre tuto pour installer n8n.

Inutile de réinstaller Docker pour mettre à jour n8n. Beaucoup de tutos font relancer le script d’installation de Docker à chaque mise à jour : ça n’a rien à voir avec n8n et ça peut mettre à jour Docker lui-même sans que tu le veuilles.

Avant de commencer

• Un accès SSH ou le terminal web de ton hébergeur (sur Hostinger : le terminal du navigateur, accessible depuis la page de ton VPS dans hPanel).
• La version actuelle de ton n8n : elle s’affiche dans n8n via Help puis About n8n. Note-la, elle sert au retour en arrière.
• Un coup d’œil aux notes de version officielles pour repérer les changements cassants, surtout si tu sautes plusieurs versions.

n8n publie une nouvelle version mineure presque chaque semaine. Au 6 octobre 2026, la page des versions de n8n sur GitHub indique la version stable 2.41.7 (pour la production) et la beta 2.42.3 (la plus récente, potentiellement instable). n8n conseille de mettre à jour au moins une fois par mois, pour éviter de sauter trop de versions d’un coup.

Étape 1 : trouver le dossier et le nom de ton conteneur n8n

Le nom du conteneur dépend de ton installation : root-n8n-1, n8n-n8n-1, n8n… Ne copie jamais un nom trouvé dans un tuto, lis le tien.

1. Liste les conteneurs en cours :

   docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}"

   Réussi si : tu vois une ligne dont l’image contient n8nio/n8n. La première colonne est le nom de ton conteneur.
2. Trouve le dossier de ton fichier Compose :

   docker compose ls

   La colonne CONFIG FILES donne le chemin du fichier. Sur le modèle Hostinger, c’est /docker/n8n.
3. Place-toi dans ce dossier, par exemple :

   cd /docker/n8n

4. Repère le nom du service (différent du nom du conteneur) :

   docker compose ps

   Réussi si : la colonne SERVICE affiche le service n8n (souvent n8n). Toutes les commandes suivantes se lancent depuis ce dossier.

Étape 2 : sauvegarder (volume et base de données)

La documentation de n8n recommande une sauvegarde complète avant chaque mise à jour. Une sauvegarde complète, c’est le dossier .n8n (qui contient la clé de chiffrement de tes identifiants, et la base SQLite par défaut) et, si tu en as une, la base PostgreSQL. Sans la clé de chiffrement, une base restaurée ne peut pas déchiffrer tes identifiants.

Le plus simple sur Hostinger : l’aide de Hostinger conseille de télécharger une sauvegarde avant la mise à jour. Fais-la depuis la page de ton VPS dans hPanel, puis complète avec la sauvegarde du volume ci-dessous si tu veux pouvoir restaurer n8n seul.

1. Trouve le nom du volume :

   docker volume ls

   Repère celui qui contient n8n (par exemple n8n_n8n_data ou n8n_data).
2. Arrête n8n, pour éviter une copie incohérente de la base SQLite :

   docker compose stop

3. Archive le volume dans le dossier courant (remplace [nom-du-volume]) :

   docker run --rm -v [nom-du-volume]:/data -v "$(pwd)":/backup alpine tar czf /backup/n8n-backup-$(date +%F).tar.gz -C /data .

   Réussi si : un fichier n8n-backup-AAAA-MM-JJ.tar.gz apparaît quand tu fais ls -lh, avec une taille supérieure à quelques kilo-octets.
4. Si tu utilises PostgreSQL, exporte aussi la base (remplace le nom du service, l’utilisateur et la base par ceux de ton fichier .env) :

   docker compose start [service-postgres]
   docker compose exec -T [service-postgres] pg_dump -U [utilisateur] [base] > n8n-db-$(date +%F).sql

Sauvegarde aussi ton fichier docker-compose.yml et ton fichier .env, qui contient N8N_ENCRYPTION_KEY si tu l’as définie.

Garde une copie de tous ces fichiers hors du serveur (sur ton ordinateur, par exemple avec scp). Une sauvegarde qui reste sur la machine qui plante ne sert à rien.

Étape 3 : mettre à jour n8n avec Docker Compose

1. Télécharge la nouvelle image :

   docker compose pull

   Réussi si : la commande se termine sans erreur et indique que l’image n8n a été téléchargée (ou qu’elle est déjà à jour).
2. Recrée les conteneurs avec la nouvelle image :

   docker compose up -d

   Docker Compose remplace seulement les conteneurs dont l’image a changé. Ton volume n’est pas touché. Pas besoin de docker compose down avant, qui arrête tout pour rien.
3. Vérifie que tout tourne :

   docker compose ps

   Réussi si : le service n8n est à l’état running (ou Up) et ne redémarre pas en boucle.
4. Lis les journaux si le service redémarre ou si la page ne charge pas :

   docker compose logs --tail=50 n8n

   Au premier démarrage après une mise à jour, n8n peut appliquer des migrations de base de données : attends qu’elles se terminent.

Une remarque sur le choix de version : si ton fichier Compose utilise l’image sans numéro (n8nio/n8n ou docker.n8n.io/n8nio/n8n), pull prend la dernière version stable. Si une version précise est écrite (par exemple n8nio/n8n:2.41.7), change ce numéro dans le fichier avant de lancer pull, sinon rien ne bouge.

Étape 4 : vérifier la version installée

Depuis le dossier du fichier Compose (remplace n8n par le nom de ton service s’il diffère) :

docker compose exec n8n n8n --version

Réussi si : le numéro affiché est plus récent que celui noté avant la mise à jour. Tu peux aussi le vérifier dans n8n, via Help puis About n8n.

Termine par un test réel : ouvre un workflow important et lance-le manuellement, puis vérifie que les workflows actifs se déclenchent bien.

Mettre à jour n8n sur Hostinger avec le bouton Update

Si tu as installé n8n avec le modèle Hostinger, l’aide officielle de Hostinger décrit deux chemins :

• Docker Manager : dans la page de ton VPS sur hPanel, ouvre Docker Manager, repère ton projet n8n, clique sur les trois points puis sur Update.
• Le terminal : cd /docker/n8n, puis les commandes de l’étape 3.

Hostinger met un docker compose down dans sa procédure ; ce n’est pas nécessaire, up -d recrée le conteneur.

Dans les deux cas, fais la sauvegarde de l’étape 2 avant, et la vérification de l’étape 4 après. Le bouton ne remplace pas la sauvegarde.

Revenir en arrière si la mise à jour casse quelque chose

1. Fixe l’ancienne version dans ton docker-compose.yml : remplace l’image du service n8n par la version notée avant la mise à jour, par exemple image: docker.n8n.io/n8nio/n8n:2.41.7.
2. Si la mise à jour comportait une migration de base de données (c’est le cas de beaucoup de versions), une ancienne version de n8n peut refuser la base migrée. La voie sûre : restaure ta sauvegarde. Arrête n8n, vide le volume et réinjecte l’archive :

   docker compose stop
   docker run --rm -v [nom-du-volume]:/data -v "$(pwd)":/backup alpine sh -c "rm -rf /data/* /data/.[!.]* ; tar xzf /backup/n8n-backup-AAAA-MM-JJ.tar.gz -C /data"

   Avec PostgreSQL, restaure aussi le fichier .sql avec les outils de PostgreSQL.
3. Relance :

   docker compose up -d

   Réussi si : docker compose exec n8n n8n --version affiche l’ancienne version et tes workflows sont là.

Pour les installations npm, la documentation de n8n prévoit aussi la commande n8n db:revert, à lancer sur la version actuelle pour annuler la dernière migration. Avec Docker, la restauration de la sauvegarde reste le chemin le plus sûr.

Mettre à jour n8n Cloud

Sur n8n Cloud, il n’y a aucune commande. Selon la documentation de n8n, le propriétaire de l’instance règle tout dans le tableau de bord Cloud, rubrique Manage puis Workspace, section Updates & maintenance :

• Version : tu peux choisir la version de ton espace. Changer de version redémarre l’instance pendant 1 à 2 minutes.
• Canal : Stable (recommandé pour la production) ou Beta (nouveautés en premier).
• Cadence : « Security & stability », une mise à niveau environ toutes les deux semaines (recommandé), ou « Every new release », en moyenne une version par jour. Les correctifs de sécurité et de stabilité s’appliquent automatiquement dans tous les cas.
• Fenêtre de maintenance : n’importe quand, ou une plage horaire que tu choisis.

Et Watchtower pour automatiser ?

Watchtower, l’outil souvent conseillé pour mettre à jour les conteneurs Docker automatiquement, n’est plus maintenu : son dépôt GitHub a été archivé le 17 décembre 2025. Je ne le recommande plus.

Et même maintenu, une mise à jour automatique de n8n sans sauvegarde ni lecture des notes de version est un pari risqué : une migration ratée la nuit, et tes workflows sont à l’arrêt au réveil. Préfère une mise à jour manuelle mensuelle, avec la procédure de ce tuto.

Les erreurs fréquentes

• « no configuration file provided » : tu n’es pas dans le dossier du fichier Compose. Retrouve-le avec docker compose ls.
• « No such container: root-n8n-1 » : le nom vient d’un autre tuto. Lis le tien avec docker ps, ou utilise docker compose exec [service] qui ne dépend pas du nom du conteneur.
• La version ne change pas : l’image est figée sur un numéro dans le fichier Compose. Modifie-le, puis relance pull et up -d.
• Identifiants illisibles après restauration : la clé de chiffrement manque. Elle est dans le dossier .n8n (ou dans la variable N8N_ENCRYPTION_KEY) : restaure le volume complet, pas seulement la base.
• Disque plein : les anciennes images s’accumulent. Une fois la mise à jour validée, docker image prune supprime les images inutilisées.

Questions fréquentes

Comment exécuter n8n avec un VPS ?

Installe Docker et Docker Compose sur le VPS, puis lance n8n avec un fichier Compose qui monte un volume pour le dossier /home/node/.n8n et expose l’interface en HTTPS. Plus simple : une offre VPS avec n8n préinstallé, comme celle de Hostinger, qui livre le serveur prêt avec le projet dans /docker/n8n.

Comment mettre à jour n8n sur Hostinger ?

Fais d’abord une sauvegarde. Ensuite, dans hPanel, ouvre Docker Manager, clique sur les trois points de ton projet n8n puis sur Update. En ligne de commande : cd /docker/n8n, puis docker compose pull et docker compose up -d.

Comment connaître ma version de n8n ?

Dans n8n, ouvre Help puis About n8n. En ligne de commande, depuis le dossier du fichier Compose : docker compose exec n8n n8n --version, en remplaçant n8n par le nom de ton service s’il est différent.

Est-ce que je perds mes workflows en mettant à jour n8n ?

Non, tant que tes données sont dans un volume Docker : la mise à jour remplace l’image, pas le volume. Une migration de base peut quand même mal se passer, d’où la sauvegarde du volume et de la base avant chaque mise à jour.

À quelle fréquence mettre à jour n8n ?

n8n conseille au moins une fois par mois, pour ne pas sauter trop de versions d’un coup. Sur n8n Cloud, la cadence recommandée applique une mise à niveau environ toutes les deux semaines, sans action de ta part.