n8n 3.0 : ce qui change et comment migrer

n8n 3.0 est en bêta depuis le 27 octobre 2026 et la version stable est annoncée pour début décembre. Elle retire une série de nœuds (Function, Function Item, Item Lists, Cron, Interval, l’ancien nœud OpenAI), ramène le délai par défaut du nœud Code de 5 minutes à 1 minute et réserve l’auto-hébergement à Docker : le rapport de migration, dans les réglages depuis la version 2.39, liste ce qui casse chez vous et corrige une partie des workflows tout seul.

Quand sort n8n 3.0 ?

La bêta 3.0.0 est disponible depuis le 27 octobre 2026, et n8n annonce la version stable pour début décembre 2026. La branche 2.x reçoit ensuite les correctifs de sécurité et de bugs critiques pendant 12 mois.

Étape	Date
Bêta 3.0.0	27 octobre 2026
Version stable 3.x	Début décembre 2026 (annoncée)
Fin du support de la 1.x	31 décembre 2026
Fin des correctifs de la 2.x	12 mois après la stable 3.x

Une instance encore en 1.x passe d’abord par la 2.x : n8n ne propose aucun chemin direct de la 1.x vers la 3.x. Les pièges de cette première marche sont détaillés dans l’article sur la migration vers n8n 2.0.

La mise à jour vers la 3.0 est à sens unique. Une fois l’instance passée, elle ne revient plus en 2.x, d’où la sauvegarde complète avant de lancer quoi que ce soit.

Quels nœuds disparaissent dans n8n 3.0 ?

Les workflows qui contiennent un nœud retiré échouent en 3.0. Pour les plus courants, n8n indique un remplaçant, et le rapport de migration sait en convertir une partie lui-même.

Nœud retiré	Remplaçant
Function, Function Item	Code (mode Run Once for All Items pour remplacer Function)
Item Lists	Split Out, Aggregate, Sort, Limit, Remove Duplicates ou Summarize
Cron, Interval	Schedule Trigger
Read PDF	Extract from File, opération PDF
Workflow Trigger	n8n Trigger
HTML Extract	Nœud HTML, opération Extract HTML Content
Manual Chat Trigger	Chat Trigger
AI Transform	Code (migration automatique)
AI Agent version 1 et ses anciens modes (Conversational, ReAct, Plan and Execute, SQL Agent, OpenAI Functions)	Tools Agent

La liste complète compte d’autres nœuds : l’ancien nœud OpenAI, OpenAI Assistant et OpenAI Model, iCalendar, Convert to/from binary data, Read/Write Binary File(s), HTTP Request Tool dans sa version ancienne, plusieurs chargeurs de documents et nœuds de vector store. Motorhead, Zep, LangChain Code et SerpApi partent sans remplaçant direct. Les versions 1 et 1.1 du nœud Edit Image disparaissent aussi.

Côté expressions, $getPairedItem est retiré. Il se remplace par $('<nœud>').item, .itemMatching(<index>) ou .pairedItem(<index>).

Le nœud Execute Sub-workflow perd ses sources Local File et URL. Les sous-workflows s’appellent depuis la base (Database) ou se définissent dans le nœud (Define Below).

Ce qui change pour le nœud Code

Le nœud Code s’arrête désormais au bout de 60 secondes par défaut, contre 300 secondes en 2.x. Un script qui parcourt un gros fichier ou appelle une API lente peut donc se mettre à échouer sans qu’on ait touché au workflow.

Le délai se règle avec la variable N8N_RUNNERS_TASK_TIMEOUT en auto-hébergé. Avant de la remonter, regardez si le traitement gagne à être découpé : un nœud Loop Over Items qui envoie les éléments par lots, comme dans le guide des boucles n8n, tient mieux qu’un script unique de plusieurs minutes.

Deux autres changements touchent le nœud Code :

l’onglet Ask AI disparaît du nœud, et le code déjà écrit continue de tourner ;
$evaluateExpression() n’est plus disponible dans le nœud Code quand les task runners tournent en mode non sécurisé (N8N_RUNNERS_INSECURE_MODE=true). La fonction reste utilisable dans les champs {{ }}.

Auto-hébergé : Docker devient obligatoire

n8n 3.0 ne s’installe plus avec npm ni avec npx n8n : l’auto-hébergement passe par Docker, avec le script d’installation en une ligne ou Docker Compose. Les déploiements Kubernetes et Helm restent tels quels.

Une instance installée avec npm se bascule donc vers Docker avant la mise à jour. La procédure locale est décrite dans le guide pour installer n8n avec Docker, et le choix entre serveur et Cloud dans le comparatif n8n auto-hébergé ou Cloud.

Réglage	En 2.x	En 3.0
`N8N_RUNNERS_TASK_TIMEOUT` (délai du nœud Code)	300 secondes	60 secondes
`N8N_UNVERIFIED_PACKAGES_ENABLED` (nœuds communautaires non vérifiés)	`true`	`false`
Exécutions manuelles en mode file d’attente	Selon `OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS`	Toujours sur les workers, la variable disparaît
Données binaires en mémoire (`N8N_DEFAULT_BINARY_DATA_MODE=default`)	Possible	Invalide, l’instance passe en `filesystem`
Dossier `~/.n8n/binaryData`	Conservé	Renommé en `~/.n8n/storage` au premier démarrage
`N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES`	2 Gio	256 Mio
`N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES`	5 000	1 000

Un nœud communautaire installé depuis npm et absent de la liste vérifiée par n8n cesse de se charger après la mise à jour. Pour le garder, il faut repasser N8N_UNVERIFIED_PACKAGES_ENABLED à true, en connaissant le risque que représente un code tiers non vérifié.

Sécurité : trois réglages par défaut plus stricts

La rotation de la clé de chiffrement est activée par défaut. Les identifiants Slack API demandent un signing secret : sans lui, un workflow qui démarre par un Slack Trigger refuse de se publier. La protection SSRF, quand elle est activée, bloque aussi de nouvelles plages d’adresses (100.64.0.0/10 notamment), qui se rouvrent avec N8N_SSRF_ALLOWED_IP_RANGES ou N8N_SSRF_ALLOWED_HOSTNAMES.

Le Gmail Trigger change de comportement : il relève 10 mails par passage par défaut (50 au maximum), ignore les brouillons sauf si l’option Include Drafts est cochée, et ne se déclenche plus sur les mails envoyés ou programmés.

Le rapport de migration : où le trouver et quoi en faire

Le rapport de migration se trouve dans Settings > Migration Report à partir de la version 2.39. Il liste les workflows touchés par la 3.0 et les réglages d’instance à revoir, et il corrige lui-même une partie des nœuds concernés.

Chaque problème porte un niveau d’impact :

Niveau dans le rapport	Ce que ça veut dire
Upgrade blocked	À corriger avant toute mise à jour
Executions will fail	Le workflow échouera en 3.0
Executions might fail	Une valeur par défaut change, le workflow peut échouer
Behavior changes	Le workflow tourne, avec un résultat différent
Capability removed	Une fonction disparaît

Quand une correction automatique existe, un bouton Migrate réécrit les nœuds concernés et enregistre le résultat comme une nouvelle version du workflow. La version publiée continue de tourner tant que vous n’avez pas cliqué sur Publish : vous relisez et testez la version migrée d’abord. La migration ne touche qu’aux nœuds, donc un test reste nécessaire avant de publier.

Les administrateurs voient tous les workflows et l’onglet Instance issues. Les autres utilisateurs ouvrent aussi le rapport, limité aux workflows qu’ils peuvent modifier. Un workflow abandonné se marque Won’t fix et compte alors comme traité ; un bandeau le propose pour les workflows qui n’ont pas tourné depuis plus de 12 mois. Le bouton Export CSV sort la liste, une ligne par problème.

Le plan avant décembre

n8n recommande quatre étapes, auxquelles s’ajoute la vérification des réglages d’instance pour l’auto-hébergé :

Mettez l’instance à jour vers la dernière 2.x, puis ouvrez le rapport de migration : la version la plus récente du rapport arrive avec la dernière 2.x.
Traitez chaque ligne : Migrate quand le bouton existe, correction à la main sinon, Won’t fix pour les workflows que vous ne gardez pas.
En auto-hébergé, relisez vos variables d’environnement avec le tableau plus haut, et basculez vers Docker si l’instance tourne avec npm.
Faites une sauvegarde complète de la base et des identifiants, puisque la mise à jour est à sens unique.
Passez une instance de test en 3.0 avant la production, faites tourner les workflows critiques, puis mettez la production à jour.

Les identifiants et l’historique des exécutions sont conservés, et la mise à jour demande un court redémarrage.

Tester la bêta sur n8n Cloud

Sur n8n Cloud, la bêta se choisit dans le changement de version de l’espace : l’option s’appelle « 3.0.0 Beta (early access) ». Le passage à Docker et les variables d’environnement ne vous concernent pas, et le rapport de migration reste l’étape à faire avant. Pour une instance neuve sans serveur à gérer, n8n Cloud évite toute la partie installation.

FAQ

Quand sort la version stable de n8n 3.0 ?

n8n annonce la version stable pour début décembre 2026. La bêta 3.0.0 est disponible depuis le 27 octobre 2026, en auto-hébergé comme sur n8n Cloud.

Peut-on revenir en 2.x après la mise à jour vers n8n 3.0 ?

La mise à jour est à sens unique : l’instance passée en 3.0 reste en 3.0. Faites une sauvegarde complète de l’instance avant, et testez sur une instance séparée.

Où se trouve le rapport de migration de n8n ?

Dans Settings > Migration Report, à partir de la version 2.39. Mettez l’instance à jour vers la dernière 2.x pour avoir la version la plus complète du rapport.

Que devient le nœud Function dans n8n 3.0 ?

Il est retiré, comme Function Item. Son remplaçant est le nœud Code, en mode Run Once for All Items, et le rapport de migration liste les workflows qui l’utilisent encore.

Par quoi remplacer le nœud Cron dans n8n 3.0 ?

Par le Schedule Trigger, qui remplace aussi le nœud Interval. Les deux anciens nœuds font échouer le workflow en 3.0.

Peut-on encore installer n8n avec npm ?

À partir de la 3.0, l’auto-hébergement passe par Docker, avec le script en une ligne ou Docker Compose. Kubernetes et Helm restent pris en charge.

Le rapport de migration fait une partie du travail, et le reste demande de savoir lire un workflow : déclencheurs, identifiants, transformation des données, boucles, gestion des erreurs. Ma formation n8n enseigne ces fondations en 31 leçons vidéo réparties en 4 chapitres. L’installation sur serveur, les agents IA et le MCP sont hors programme. Pour tout le reste sur l’outil, le hub n8n regroupe les guides du site.

Sources : n8n · Introducing n8n 3.0, n8n Docs · changements de la 3.0, n8n Docs · rapport de migration, n8n Docs · installation en une ligne.

n8n 3.0 en bêta : ce qui change et comment préparer la migration