nous contacter

Blog · Technique & intégrations

Mettre à jour n8n sous Docker sans perdre de données (et préparer n8n 3.0)

Mettre à jour n8n sous Docker sans rien perdre : sauvegarde Postgres et clé, préproduction, version épinglée, retour arrière et checklist n8n 3.0.

Publié le 29 octobre 2026

Illustration pour mettre à jour n8n sous Docker : sauvegarde, préproduction, montée de version et retour arrière
Illustration : GetBatch

Mettre à jour n8n sous Docker prend trois commandes, mais le faire sans perdre de données demande une routine : sauvegarder la base et la clé de chiffrement, tester la nouvelle version sur une copie, monter de version avec un numéro épinglé, et garder un retour arrière prêt. Sans ces précautions, une mise à jour ratée peut rendre vos identifiants illisibles ou bloquer des workflows en production. Le sujet devient pressant : n8n a publié le 27 octobre 2026 la première version de n8n 3.0, une version majeure qui retire des nœuds et change des réglages par défaut. Voici la routine que nous appliquons sur les instances que nous maintenons, puis la liste de ce qu’il faut vérifier avant de passer en version 3.

Pourquoi mettre à jour n8n maintenant ?

Parce que la version 3 arrive, et qu’elle ne se passera bien que sur une instance déjà à jour.

D’après la page des versions de n8n sur GitHub, n8n 3.0.0 a été publiée le 27 octobre 2026 et n8n 3.0.1 le lendemain, toutes deux marquées « pre-release ». La version stable, marquée « Latest », reste la 2.45.5, publiée le 28 octobre. Dans son annonce sur X, n8n présente cette version comme une version sans grande nouveauté, centrée sur la fiabilité, la stabilité et la sécurité, qui regroupe les changements incompatibles accumulés depuis un an. La version stable est annoncée pour début décembre.

Autrement dit : vous avez environ un mois pour remettre votre instance d’aplomb. Une instance restée en 2.20 qui saute directement en 3.x cumule deux risques à la fois, ce que la documentation de n8n déconseille. Ses bonnes pratiques de mise à jour recommandent de mettre à jour au moins une fois par mois, de lire les notes de version et de tester d’abord sur une instance de test.

Au-delà de la version 3, chaque version mineure apporte des correctifs de sécurité. Une instance auto-hébergée exposée sur internet et jamais mise à jour est une porte ouverte, comme nous le rappelons dans intégrateur n8n : 7 questions à poser avant de signer.

Que faut-il sauvegarder avant de mettre à jour n8n ?

Plus que les workflows. La documentation de sauvegarde de n8n distingue deux éléments indispensables :

  1. Le dossier .n8n (le volume n8n_data monté sur /home/node/.n8n dans Docker). Il contient le fichier config qui stocke la clé de chiffrement des identifiants. Avec SQLite, il contient aussi la base elle-même, et les données binaires si elles sont stockées sur disque.
  2. La base PostgreSQL, si vous l’utilisez (c’est notre configuration standard en production). Elle contient les workflows, les identifiants chiffrés, les utilisateurs et l’historique d’exécution.

S’y ajoutent votre fichier docker-compose.yml et votre fichier .env, les dossiers de nœuds personnalisés, et le stockage externe (S3, par exemple) si vous en avez configuré un.

Point clé : sans la clé de chiffrement, une base restaurée ne sert à rien. Les identifiants y sont chiffrés, et n8n ne peut pas les relire avec une autre clé. Nous la fixons toujours dans la variable N8N_ENCRYPTION_KEY et la rangeons dans un coffre de mots de passe, à part du serveur.

Les commandes n8n export:workflow --backup et n8n export:credentials --backup sont utiles pour déplacer des workflows, mais la documentation précise qu’elles n’exportent ni les utilisateurs, ni l’historique d’exécution, ni les variables, ni la clé. Elles ne remplacent pas une vraie sauvegarde.

Voici les deux commandes que nous lançons avant chaque mise à jour, depuis le dossier du fichier compose (adaptez le nom du service Postgres et du volume, visibles avec docker compose ps et docker volume ls) :

# 1. Sauvegarde de la base Postgres au format compressé
docker compose exec -T postgres pg_dump -U n8n -d n8n -Fc > backups/n8n-$(date +%F).dump

# 2. Sauvegarde du volume .n8n (clé de chiffrement, données binaires)
docker run --rm -v n8n_n8n_data:/data -v "$(pwd)/backups":/backup alpine \
  tar czf /backup/n8n_data-$(date +%F).tar.gz -C /data .

Une sauvegarde qui n’a jamais été restaurée n’est qu’une hypothèse. C’est précisément l’étape suivante qui la met à l’épreuve.

Comment mettre à jour n8n sous Docker pas à pas ?

Routine pour mettre à jour n8n sous Docker en cinq étapes : lire les notes de version, sauvegarder, tester en préproduction, monter la version épinglée, vérifier Notre routine de mise à jour : la production ne change qu’après un test réussi sur une copie restaurée.

1. Lire les notes de version

Avant de toucher au serveur, nous lisons les notes de version entre la version installée et la version visée. n8n suit le versionnement sémantique : un changement du premier chiffre (2 vers 3) signale des changements qui peuvent demander une action de votre part. On cherche les nœuds dépréciés, les variables d’environnement renommées et les changements de comportement.

2. Sauvegarder

Les deux commandes ci-dessus, puis une copie des sauvegardes hors du serveur. Un VPS qui tombe emporte avec lui les sauvegardes stockées dessus.

3. Tester sur une préproduction

Nous restaurons la sauvegarde du jour sur une deuxième instance (un autre petit VPS, ou un deuxième fichier compose sur un port différent), avec les workflows désactivés pour ne rien envoyer en double. Nous y installons la nouvelle version, puis nous rejouons à la main les workflows critiques : ceux qui touchent la facturation, le CRM ou les clients. Ce test vérifie à la fois la nouvelle version et la sauvegarde elle-même.

4. Épingler la version et monter

En production, nous n’utilisons jamais l’étiquette latest ni de mise à jour automatique type Watchtower. La version est écrite en clair dans le fichier compose, ce qui rend chaque montée de version volontaire et réversible :

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:2.45.5   # version testée en préproduction
    env_file: .env
    volumes:
      - n8n_data:/home/node/.n8n

Puis, comme l’indique la documentation Docker de n8n :

docker compose pull
docker compose down
docker compose up -d

Nous choisissons un créneau creux (tôt le matin ou le week-end) et prévenons l’équipe : l’interruption dure en général une à deux minutes, le temps que n8n applique ses migrations de base au démarrage. Les webhooks reçus pendant ce laps de temps échouent côté émetteur, d’où l’intérêt du créneau.

5. Vérifier

docker compose exec n8n n8n --version
docker compose logs -f n8n

Nous vérifions que les migrations se sont terminées sans erreur dans les journaux, que les workflows actifs le sont toujours, puis nous surveillons les premières exécutions réelles. Un workflow d’erreur centralisé, qui envoie une alerte sur Teams ou Slack, permet de repérer un échec avant les clients.

Comment revenir en arrière si la mise à jour de n8n se passe mal ?

Retour arrière après une mise à jour de n8n : remettre l'ancienne image ne suffit pas, il faut aussi restaurer la base sauvegardée avant la mise à jour Remettre l’ancien numéro de version ne suffit pas : la base a déjà été migrée par la nouvelle version.

C’est le piège le plus courant. Au démarrage, la nouvelle version modifie la structure de la base, et la documentation de n8n rappelle que ces migrations ne vont que dans un sens. Remettre simplement l’ancien numéro de version dans le fichier compose peut donc laisser une ancienne version face à une base qu’elle ne sait pas lire.

Le vrai retour arrière se fait en quatre gestes :

  1. arrêter n8n (docker compose down) ;
  2. restaurer la base sauvegardée juste avant la mise à jour (pg_restore --clean --if-exists -U n8n -d n8n) et, si besoin, le volume .n8n ;
  3. remettre l’ancien numéro de version dans le fichier compose ;
  4. redémarrer (docker compose up -d) et vérifier.

Les exécutions survenues entre la mise à jour et le retour arrière sont perdues de l’historique. C’est une raison de plus pour décider vite : si les vérifications de l’étape 5 échouent, nous revenons en arrière dans l’heure, puis nous analysons à froid sur la préproduction.

n8n 3.0 : que vérifier avant de passer en version 3 ?

La liste officielle des changements incompatibles de n8n 3.0 est longue. La bonne nouvelle : n8n fournit un outil qui fait le tri pour vous.

Le rapport de migration

Dans votre instance 2.x à jour, le menu Settings > Migration Report liste les workflows et les réglages concernés par la version 3. D’après la documentation de l’outil, chaque point porte un niveau d’impact, de « Upgrade blocked » (la mise à jour ne passera pas) à « Executions might fail » (un réglage par défaut change). Seuls le propriétaire de l’instance et les administrateurs voient l’onglet des réglages de l’instance. C’est la première chose à ouvrir, et une raison de plus de monter d’abord sur la dernière 2.x.

Les changements qui touchent le plus les PME

Changement en n8n 3.0Ce qu’il faut faire
Installation npm ou npx n8n plus prise en charge : Docker obligatoirePasser en Docker (idéalement Docker Compose avec Postgres) avant la mise à jour
Nœuds supprimés : Function, Function Item, Item Lists, Cron, Interval, Read Binary File, Read PDF, HTML Extract, ancien nœud OpenAI…Remplacer par Code, Schedule Trigger, Read/Write Files from Disk, Extract from File, HTML
Délai des tâches du nœud Code ramené de 5 minutes à 1 minute (N8N_RUNNERS_TASK_TIMEOUT)Fixer la variable si certains traitements sont longs, ou les sortir dans une application Python
Nœuds communautaires non vérifiés désactivés par défautFixer N8N_UNVERIFIED_PACKAGES_ENABLED=true ou passer aux nœuds vérifiés
Dossier binaryData renommé en storage, n8n refuse de démarrer si les deux existentAdapter le montage du volume, ou fixer N8N_STORAGE_PATH
Mode mémoire des données binaires suppriméFixer N8N_DEFAULT_BINARY_DATA_MODE (filesystem, s3, azure ou database)
Version 1 du nœud AI Agent retiréePasser les agents sur la dernière version (mode Tools Agent)
Rotation des clés de chiffrement activée par défautRien de spécial, mais sauvegarder la base avant, comme toujours

Le délai d’une minute sur le nœud Code est celui qui risque de surprendre le plus d’équipes. Chez nous, quand un traitement dépasse quelques secondes (lecture de gros PDF, calculs, appels en série), nous le confions de toute façon à une petite application Python appelée par n8n : le workflow reste lisible et le délai n’est plus un sujet.

Notre calendrier conseillé

  1. Novembre : monter sur la dernière 2.x stable avec la routine ci-dessus, ouvrir le rapport de migration, corriger les workflows signalés.
  2. Début décembre : à la sortie de la version stable, tester la 3.x sur la préproduction.
  3. Quelques semaines plus tard : passer en production, une fois les premiers correctifs publiés.

Nous déconseillons d’installer une version marquée « pre-release » sur une instance de production. Elle est faite pour être testée.

À quelle fréquence mettre à jour n8n ?

Une fois par mois, comme le recommande n8n, est un bon rythme pour une PME : l’écart entre deux versions reste faible et chaque mise à jour se fait en moins d’une heure, test compris. Les correctifs de sécurité urgents passent en dehors de ce rythme.

Le vrai sujet est de savoir qui s’en charge. Sur beaucoup d’instances que nous reprenons, n8n a été installé une fois, puis plus personne n’y a touché pendant un an. Si votre instance a été installée par un prestataire, vérifiez que la maintenance figure au contrat et que le serveur est bien à votre nom, comme nous l’expliquons dans notre article sur la propriété du code et la réversibilité. Et si vous venez de quitter Zapier ou Make, c’est le bon moment pour installer cette routine dès le départ : voir migrer de Zapier vers n8n.

Pour une équipe qui ne veut pas gérer ces opérations, notre agence n8n inclut la sauvegarde, la préproduction et les montées de version dans la maintenance des instances que nous hébergeons sur des serveurs en France.

Questions fréquentes

Mes workflows sont-ils perdus quand je mets à jour n8n ?

Non, si vos données sont dans un volume Docker et une base Postgres, ce qui est le cas d’une installation correcte. Ils sont perdus si le conteneur a été lancé sans volume : les données vivent alors dans le conteneur et disparaissent avec lui. Vérifiez la présence d’un volume monté sur /home/node/.n8n avant toute mise à jour.

Faut-il installer n8n 3.0 dès maintenant ?

Pas en production. Les versions 3.0.0 et 3.0.1 sont marquées « pre-release » et la version stable est annoncée pour début décembre 2026. En revanche, rien n’empêche de la tester dès maintenant sur une préproduction restaurée à partir de vos données.

Peut-on automatiser les mises à jour de n8n avec Watchtower ?

C’est possible, mais nous le déconseillons en production : une version majeure ou un changement de réglage par défaut peut passer sans que personne ne l’ait lu. Nous préférons une version épinglée, mise à jour volontairement après un test.

Combien de temps dure une mise à jour de n8n ?

L’interruption de service elle-même dure en général une à deux minutes. Avec la sauvegarde, le test en préproduction et les vérifications, comptez environ une heure pour une instance de PME, davantage pour un saut de version majeure comme le passage en 3.0.

Vous préférez déléguer les mises à jour et la préparation de n8n 3.0 ? Notre agence n8n audite votre instance, corrige les workflows signalés par le rapport de migration et prend en charge les montées de version. Parlons de votre instance.

→À lire ensuite