n8n 3.0 en accès anticipé : Docker obligatoire et anciens nœuds retirés

n8n est un outil d'automatisation très utilisé par les petites équipes, notamment parce qu'on peut l'héberger soi-même. Sa version 3.0.0 est sortie en accès anticipé, sans date de disponibilité générale annoncée. La documentation officielle liste les changements dits « cassants », c'est-à-dire ceux qui peuvent arrêter des automatisations existantes. Ils sont nombreux.

Docker devient obligatoire

C'est le changement le plus structurant pour une instance auto-hébergée : l'installation par npm ou npx n8n n'est plus prise en charge. n8n 3.0 ne publie plus de paquet exécutable sur npm. Il faut passer par Docker avant de mettre à jour.

La documentation propose une installation en une ligne :

curl -fsSL https://get.n8n.io | sh

Pour une équipe ou une production, n8n recommande plutôt Docker Compose avec une base Postgres, à la place de la base SQLite fournie par défaut. Si vous utilisez déjà votre propre fichier Docker Compose, rien ne change sur ce point.

Les nœuds retirés

Un flux qui contient un nœud retiré échoue à l'exécution. Plus gênant : un flux publié qui en contient un ne s'active pas au démarrage, donc son déclencheur ne se lance plus. Parmi les retraits :

• Function et Function Item, remplacés par le nœud Code ;
• Cron et Interval, remplacés par Schedule Trigger ;
• Item Lists, Read PDF, HTML Extract et les anciens nœuds de fichiers binaires ;
• les anciens nœuds OpenAI et la version 1 du nœud AI Agent, avec ses modes historiques ;
• AI Transform, que l'on ne peut plus ajouter ni exécuter.

Certains n'ont pas de remplaçant direct, comme LangChain Code ou le nœud SerpApi.

Des comportements qui changent sans bruit

• Gmail Trigger : les anciennes versions se comportent comme la 1.4. Les brouillons sont ignorés sauf option contraire, et les courriels envoyés ou programmés ne déclenchent plus de flux.
• Slack : l'identifiant de connexion exige désormais un secret de signature. Sans lui, les flux Slack Trigger déjà publiés cessent de recevoir des événements.
• Nœuds communautaires non vérifiés : ils ne se chargent plus par défaut. Il faut passer N8N_UNVERIFIED_PACKAGES_ENABLED à true pour les conserver.
• Délai des tâches : N8N_RUNNERS_TASK_TIMEOUT passe de 300 à 60 secondes.
• Compression : la taille maximale décompressée passe de 2 Gio à 256 Mio.
• Stockage : le dossier ~/.n8n/binaryData est renommé ~/.n8n/storage. n8n refuse de démarrer si les deux existent.

Côté sécurité, la rotation de la clé de chiffrement est activée par défaut et la liste des plages d'adresses bloquées contre les attaques de type SSRF s'allonge.

L'outil de migration

n8n fournit un rapport de migration, accessible dans Settings > Migration Report. Il liste les flux et les réglages de l'instance qui demandent une intervention, et peut convertir certains nœuds automatiquement, par exemple AI Transform vers Code. La documentation demande de sauvegarder la base de données avant toute chose.

Les limites à garder en tête

La page ne dit pas quand la 3.0 deviendra la version stable ; les notes de version indiquent pour l'instant la 2.47.3 comme version stable. Le rapport ne corrige pas tout : un nœud AI Transform qui n'a jamais généré de code doit être remplacé à la main, et les flux d'image doivent être retestés car le nœud Edit Image change de bibliothèque.

Notre lecture

Pour une PME qui fait tourner n8n sur un petit serveur, rien ne presse : restez sur la branche 2.x tant que la 3.0 est en accès anticipé. En revanche, le travail préparatoire peut commencer maintenant. Trois actions utiles : passer à Docker si l'instance tourne encore avec npm, ouvrir le rapport de migration pour mesurer l'ampleur du chantier, et remplacer dès aujourd'hui les nœuds Function, Cron et Interval. Si un prestataire a monté vos automatisations il y a deux ou trois ans, demandez-lui ce rapport : les flux les plus anciens sont les plus exposés.