Tuto pour installer n8n en local avec npm ou Docker

Installer n8n en local permet d’auto-héberger cet outil d’automatisation sans limitation d’exécutions ni abonnement mensuel. Vous gardez la souveraineté totale sur vos données, accédez à tous les Community Nodes et pouvez travailler hors ligne. Ce tutoriel détaille deux méthodes éprouvées en 2026 pour les développeurs, les prototypistes et les entreprises soucieuses de la conformité RGPD.

---

Préparer votre environnement

Une installation fluide de n8n repose sur une machine correctement dimensionnée. Prévoyez au minimum 2 Go de RAM (et idéalement 4 Go pour les workflows avec IA) ainsi qu’un processeur x64 ou ARM64. Les machines Apple Silicon, les Raspberry Pi 5 ou un PC Windows avec WSL2 fonctionnent très bien.

Logiciels requis

• Node.js version LTS 20.x ou supérieure (avec npm) pour la méthode rapide.
• Docker Desktop (recommandé) pour une installation isolée et persistante.
• Sur Windows, activez WSL2 avant d’installer Docker.
• Un navigateur récent (Chrome, Firefox ou Edge).

Choix de la méthode

La méthode via npm sert surtout à tester rapidement l’outil. L’installation avec Docker reste plus adaptée à une « production » locale, car elle s’appuie sur un volume persistant qui protège vos workflows lors des mises à jour. Les deux approches sont présentées pas à pas ci‑dessous.

1. Installer n8n via npm

Cette méthode légère convient bien au développement et aux tests sur votre machine. Elle s’effectue en général en moins de cinq minutes.

Installer Node.js

Téléchargez la version LTS de Node.js depuis le site officiel nodejs.org, puis lancez l’installateur. Une fois l’opération terminée, ouvrez un terminal et vérifiez l’installation avec les commandes suivantes :

node -v
npm -v

Les deux commandes doivent afficher un numéro de version, signe que Node.js et npm sont correctement installés.

Déployer n8n

Dans le même terminal, exécutez ensuite la commande globale suivante pour installer n8n sur votre machine :

npm install n8n -g

Une fois l’installation terminée, lancez n8n avec la commande suivante :

n8n start

L’interface est alors accessible à l’adresse http://localhost:5678, directement depuis votre navigateur.

2. Déployer n8n avec Docker

Cette méthode, plus robuste, isole n8n dans un conteneur Docker et préserve vos données grâce à un volume persistant.

Créer le volume persistant

Ouvrez un terminal sur la machine hôte, puis exécutez la commande suivante :

docker volume create n8n_data

Ce volume conservera tous vos workflows, identifiants et paramètres, même après l’arrêt ou le redémarrage du conteneur.

Lancer le conteneur

Lancez ensuite le conteneur n8n avec la commande suivante :

docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

Vous pouvez aussi passer par l’interface graphique de Docker Desktop : recherchez l’image n8nio/n8n, mappez le port 5678 et liez le volume n8n_data au chemin /home/node/.n8n.

3. Configurer votre première instance

Une fois n8n démarré, ouvrez votre navigateur et rendez-vous à http://localhost:5678. L’assistant de configuration apparaît à l’écran.

Créer le compte propriétaire

Indiquez une adresse email et un mot de passe d’au moins 8 caractères. Ce compte aura les droits d’administrateur. Choisissez un mot de passe robuste, surtout si vous envisagez d’exposer l’instance ultérieurement.

Activer la licence Community

Dans le menu Settings, activez la licence Community Edition. Vous débloquez ainsi l’accès complet aux Community Nodes, aux fonctions avancées d’IA et à l’édition JSON des workflows.

Points de sécurité essentiels

N’exposez jamais n8n directement sur internet sans protection solide. Utilisez un reverse proxy comme Nginx avec SSL/TLS, ou un tunnel chiffré de type Cloudflare Tunnel. Une instance sans mot de passe constitue une faille majeure.

4. Créer votre premier workflow

n8n s’organise autour de nœuds reliés entre eux sur un canvas visuel. Depuis l’écran d’accueil, cliquez sur « Add first step » pour créer votre premier workflow.

Commencez en général par un nœud Trigger (Schedule Trigger, Webhook ou Manual Trigger). Ajoutez ensuite les nœuds nécessaires : HTTP Request pour appeler une API, traitements JSON, intégration Gmail, etc. Le canvas permet de relier les nœuds par simple glisser‑déposer.

Cliquez sur « Execute Workflow » pour lancer un test immédiat. Quand le résultat vous convient, enregistrez le workflow pour le réutiliser.

5. Maintenir et optimiser n8n

Une maintenance régulière garantit la stabilité et la sécurité de votre installation locale.

Mettre à jour n8n

Pour la version installée via npm sur votre machine, utilisez tout simplement :

npm install n8n@latest -g

Pour une instance exécutée avec Docker, mettez l’image à jour avec :

docker pull docker.n8n.io/n8nio/n8n

Relancez ensuite le conteneur. Le volume persistant conservera intactes vos données et vos workflows.

Gérer les webhooks en local

Les services externes ne peuvent pas appeler directement localhost. Pour tester des webhooks (Stripe, Typeform, etc.), démarrez n8n avec la commande suivante :

n8n start --tunnel

Pour une solution plus durable, mettez en place un tunnel permanent via Cloudflare ou un reverse proxy accessible depuis internet.

Astuce : vous pouvez définir des variables d’environnement dans un fichier .env ou via la configuration Docker pour stocker vos clés API, sans les inscrire en clair dans les workflows.