Installer n8n en local : le guide complet (Docker et npm)

Bonne nouvelle : pour découvrir n8n, vous n’avez besoin ni de serveur, ni d’abonnement, ni de carte bancaire. En une dizaine de minutes, vous pouvez faire tourner n8n gratuitement sur votre propre ordinateur — Windows, Mac ou Linux — et commencer à construire vos premiers workflows.

Dans ce tutoriel complet, nous voyons les deux méthodes d’installation (Node.js et Docker), comment lancer n8n, créer votre compte local, conserver vos données et mettre à jour l’outil. Avec, en bonus, les solutions aux erreurs les plus fréquentes.

Vous hésitez encore entre cloud et self-host ? Lisez d’abord notre guide n8n Cloud vs self-host.

Avant de commencer : ce qu’il vous faut

• Un ordinateur récent (Windows 10/11, macOS ou Linux) avec environ 1 Go d’espace libre.
• Des droits d’administrateur pour installer un logiciel.
• 10 à 15 minutes devant vous.

Deux chemins s’offrent à vous. Choisissez selon votre profil :

Méthode 1 — Lancer n8n avec Node.js (le plus rapide)

Étape 1 : installer Node.js

Node.js est l’environnement qui fait tourner n8n. Téléchargez la version LTS (Long Term Support) sur le site officiel nodejs.org, puis installez-la en laissant les options par défaut. Pour vérifier l’installation, ouvrez un terminal (Invite de commandes sur Windows, Terminal sur Mac) et tapez :

node --version

Si une version s’affiche (par exemple v20.x.x), c’est gagné.

Étape 2 : lancer n8n

Toujours dans le terminal, une seule commande suffit :

npx n8n

La première fois, le téléchargement prend deux ou trois minutes. Quand vous voyez le message « Editor is now accessible via: http://localhost:5678 », ouvrez votre navigateur à l’adresse :

http://localhost:5678

Et voilà : n8n tourne sur votre machine. 🎉

Méthode 2 — Installer n8n avec Docker (recommandée)

Docker fait tourner n8n dans un conteneur isolé : rien ne s’éparpille dans votre système, les mises à jour sont triviales et vous reproduisez à l’identique ce que vous ferez plus tard sur un serveur. C’est la méthode que nous recommandons dès que vous dépassez le simple essai.

Étape 1 : installer Docker Desktop

Téléchargez Docker Desktop depuis le site officiel docker.com et installez-le (sur Windows, il peut vous demander d’activer WSL 2 : acceptez, l’assistant s’occupe de tout). Lancez ensuite Docker Desktop et attendez que son icône indique qu’il est démarré.

Étape 2 : créer un volume pour vos données

Un volume est un espace de stockage persistant : vos workflows et identifiants y survivront aux redémarrages. Dans le terminal :

docker volume create n8n_data

Étape 3 : lancer n8n

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

Décodons cette commande : -p 5678:5678 ouvre la porte d’accès locale, -v n8n_data:… branche votre volume de données, et l’image officielle n8nio/n8n est téléchargée automatiquement. Ouvrez ensuite http://localhost:5678 dans votre navigateur, comme pour la méthode 1.

Premier démarrage : créer votre compte local

À la première ouverture, n8n vous demande de créer un compte propriétaire (e-mail + mot de passe). Ce compte est purement local — il ne crée rien sur les serveurs de n8n — et protège l’accès à votre instance. Renseignez-le, répondez (ou non) au mini-questionnaire, et vous arrivez sur l’écran d’accueil, prêt à créer votre premier workflow.

Arrêter, relancer et mettre à jour n8n

Arrêter

Dans le terminal où n8n tourne : Ctrl + C. Avec Docker en arrière-plan : docker stop n8n.

Relancer

Méthode Node.js : retapez npx n8n. Méthode Docker : relancez la commande docker run (vos données sont dans le volume, vous retrouvez tout).

Mettre à jour

# Méthode Node.js
npm update -g n8n

# Méthode Docker : récupérer la dernière image
docker pull docker.n8n.io/n8nio/n8n

Les problèmes fréquents (et leurs solutions)

• « node n’est pas reconnu… » → Node.js n’est pas installé ou le terminal n’a pas été rouvert après l’installation. Fermez et rouvrez le terminal.
• « port 5678 already in use » → une autre instance de n8n tourne déjà. Fermez-la, ou changez de porte : -p 5679:5678 (puis ouvrez localhost:5679).
• Docker affiche « Cannot connect to the Docker daemon » → Docker Desktop n’est pas démarré. Lancez-le et attendez l’icône verte.
• Page blanche dans le navigateur → attendez quelques secondes que le démarrage se termine, puis rechargez avec Ctrl + F5.
• J’ai perdu mes workflows après redémarrage (Docker) → le conteneur a été lancé sans le volume -v n8n_data:/home/node/.n8n. Relancez toujours avec cette option.

FAQ — vos questions fréquentes

Mon n8n local est-il accessible depuis Internet ?

Non, et c’est volontaire : localhost n’est visible que depuis votre ordinateur. C’est idéal pour apprendre. Pour des webhooks publics (recevoir des événements de services externes), il faudra plus tard héberger n8n sur un VPS avec un nom de domaine — c’est l’objet de notre module Expert.

Mes workflows sont-ils sauvegardés automatiquement ?

Oui : n8n stocke tout dans son dossier de données (le volume n8n_data avec Docker, le dossier ~/.n8n avec Node.js). Pensez quand même à exporter régulièrement vos workflows importants (menu du workflow → Download) : un fichier JSON = une sauvegarde portable.

Puis-je connecter Gmail, Notion ou Slack depuis une installation locale ?

Oui pour la plupart des services : les connexions sortantes fonctionnent normalement. Seule limite : les déclencheurs par webhook entrant (recevoir des notifications en temps réel), qui nécessitent une instance accessible en ligne. En local, utilisez plutôt des déclencheurs planifiés (Schedule).

Quelle est la différence entre npx n8n et npm install -g n8n ?

npx télécharge et exécute n8n à la demande (idéal pour un essai ponctuel) ; npm install -g l’installe durablement sur votre machine, ce qui accélère les lancements suivants. Pour un usage régulier, préférez l’installation globale… ou mieux : Docker.

En résumé

Installer n8n en local, c’est : Node.js + npx n8n pour l’essai express, ou Docker + un volume pour une installation propre et durable. Dans les deux cas : gratuit, illimité, et vos données restent chez vous.

Votre instance tourne ? Parfait. Place au concret : créons ensemble votre premier workflow n8n, pas à pas.