Installation via npm

npm est l’un des moyens les plus rapides pour démarrer n8n sur votre machine locale. Vous devez avoir préalablement installé Node.js. n8n nécessite une version de Node.js comprise entre 20.19 et 24.x (bornes incluses).

Versions stable et bêta

n8n publie presque chaque semaine une nouvelle version mineure. La version stable est conçue pour un usage en production, tandis que la version beta correspond à la dernière version publiée et peut ne pas être entièrement stable. Pour signaler des problèmes, veuillez utiliser le forum communautaire.

Version stable actuelle : 2.10.2
Version beta actuelle : 2.11.1

Tester n8n avec npx

Vous pouvez tester n8n sans l’installer, directement via npx.

Exécutez la commande suivante dans votre terminal :

npx n8n

Cette commande téléchargera tout ce qui est nécessaire pour lancer n8n. Une fois terminé, ouvrez votre navigateur à l’adresse http://localhost:5678 pour accéder à n8n et commencer à créer vos workflows.

Installation globale de n8n (via npm)

Installez n8n globalement avec npm :

npm install n8n -g

Utilisez la syntaxe @ pour installer ou mettre à jour vers une version spécifique de n8n. Par exemple :

npm install -g [email protected]

Pour installer la version next :

npm install -g n8n@next

Une fois l’installation terminée, lancez n8n avec l’une des commandes suivantes :

n8n
# ou
n8n start

Étapes suivantes

Consultez le guide de démarrage rapide pour découvrir les fonctionnalités de n8n.

Mise à jour

Mettez à jour votre instance n8n vers la dernière version (latest) :

npm update -g n8n

Pour installer la version next :

npm install -g n8n@next

Utilisation du tunnel n8n

⚠️ Attention

À utiliser uniquement pour le développement et les tests locaux. Ne convient pas à un environnement de production.

Outil de développement

La fonctionnalité de tunnel est un outil pratique pour le développement local. Son implémentation sous-jacente peut évoluer d’une version de n8n à l’autre.

Pour utiliser les nœuds déclencheurs Webhook avec des services externes comme GitHub, votre instance n8n doit être accessible depuis Internet. n8n propose un service de tunnel basé sur cloudflared qui redirige les requêtes réseau vers votre instance locale. Ce tunnel nécessite Docker.

Prérequis : Docker

Le tunnel utilise cloudflared, qui s’exécute dans un conteneur Docker. Même si vous exécutez n8n via npm, vous devez installer Docker sur votre machine.

Pour une installation via npm, utilisez l’approche « service seul » : démarrez cloudflared comme un service indépendant, puis lancez n8n localement :

# Terminal 1 : démarrer le service de tunnel cloudflared
pnpm --filter n8n-containers services --services cloudflared

# Terminal 2 : démarrer n8n localement
pnpm dev

La commande services démarre cloudflared, récupère une URL publique de tunnel, et crée un fichier .env contenant les variables WEBHOOK_URL et N8N_PROXY_HOPS=1 dans packages/cli/bin/.env. n8n lit automatiquement ce fichier .env au démarrage.

Pour nettoyer après utilisation :

pnpm --filter n8n-containers services:clean

Pour une configuration complète (n8n et cloudflared tous deux dans des conteneurs), consultez la documentation sur la configuration du tunnel avec Docker.

Revenir à une version antérieure

Installez la version antérieure vers laquelle vous souhaitez revenir.

Si la mise à niveau incluait des migrations de base de données :

1. Consultez la documentation des fonctionnalités et les notes de version pour savoir si des modifications manuelles sont nécessaires.
2. Exécutez n8n db:revert sur la version actuelle pour annuler la dernière migration de base de données. Si plusieurs migrations doivent être annulées, répétez cette opération autant de fois que nécessaire.

Dépannage sous Windows

Si vous rencontrez des problèmes lors de l’exécution de n8n sous Windows, assurez-vous que votre environnement Node.js est correctement configuré. Reportez-vous au guide Microsoft : Installer Node.js sur Windows.