Installer n8n en local (Windows, Mac, Linux) : les méthodes avec et sans Docker

Tu peux lancer n8n en local avec une commande, mais le choix de la méthode détermine surtout ce qui se passe après le premier test. Sur Windows, macOS et Linux, npx permet d’ouvrir rapidement l’interface sans installation durable, tandis que Docker convient mieux à une instance qui doit conserver ses workflows. Dans les deux cas, une installation locale ne s’administre pas toute seule : les mises à jour, les sauvegardes et la sécurité restent à prévoir.

Pour illustrer les différences, suivons Mina, qui gère une petite boulangerie et veut relier son formulaire de commandes à une feuille de suivi. Elle peut tester l’automatisation des workflows sur son ordinateur avant de décider si l’outil doit tourner en continu. La bonne question n’est donc pas seulement « quelle commande lancer ? », mais aussi « qui prendra soin de l’instance ensuite ? ».

En bref

• Pour essayer n8n, lance npx n8n avec une version compatible de Node.js, puis ouvre http://localhost:5678.
• Pour conserver tes données, Docker et un volume persistant offrent un environnement plus facile à recréer.
• Pour Windows, Docker Desktop s’appuie généralement sur WSL2 ; sur macOS, Docker Desktop est une option, et Linux peut utiliser Docker Engine.
• Évite l’ancienne installation globale avec npm install n8n -g : elle est signalée comme dépréciée dans la documentation à partir de n8n 3.0.
• Avant de choisir, décide qui assurera les sauvegardes, les mises à jour et la surveillance.

Choisir une installation locale de n8n selon son usage

Les trois voies présentées par n8n ne répondent pas au même besoin. npx sert à tester, Docker à héberger soi-même une instance, et n8n Cloud à utiliser le service sans gérer la machine qui l’exécute. Seules les deux premières correspondent à une installation locale ou auto-hébergée.

Mina commence par vérifier son objectif. Si elle veut seulement voir comment relier un formulaire à une feuille de calcul, elle n’a pas besoin de configurer un serveur. Si, en revanche, elle veut que ses automatisations tournent chaque matin même lorsque son ordinateur est fermé, un lancement temporaire sur son portable ne suffira pas.

La documentation consultée le 17 septembre 2026 indique une plage de versions Node.js compatible allant de 20.19 à 24.x inclus. Vérifie la version installée avant de lancer n8n : une version trop ancienne ou hors de cette plage peut provoquer des erreurs difficiles à diagnostiquer. La commande node -v permet de contrôler ce point dans un terminal.

Une vieille recette circule encore sur les blogs : installer n8n globalement avec npm install n8n -g, puis le lancer avec n8n start. Cette méthode est dépréciée selon la documentation à partir de n8n 3.0. Un tutoriel qui la présente comme la voie normale mérite donc une vérification avant d’être suivi.

Pour comparer les usages de n8n avec ceux d’un autre outil d’automatisation, tu peux aussi consulter ce guide sur n8n face à Zapier. Le choix d’un outil vient après le besoin : une automatisation qui ne résout aucun problème concret reste une tâche de plus à maintenir.

Installation sans Docker avec Node.js sur Windows, macOS et Linux

Pour un premier essai, l’installation sans Docker est directe : Node.js fournit l’environnement nécessaire et npx lance n8n sans installer durablement le paquet dans tout le système. Cette approche convient à une démonstration, à la découverte de l’interface ou à la construction d’un prototype sur sa propre machine.

Commence par installer une version de Node.js compatible, puis ouvre le terminal approprié. Sur Windows, tu peux utiliser PowerShell ou le terminal Windows ; sur macOS, l’application Terminal ; sur Linux, le terminal de ta distribution. Une fois l’installation effectuée, vérifie les versions avec node -v et npm -v.

La commande de lancement reste la même sur les trois systèmes :

npx n8n

Lors du premier lancement, npx peut demander l’autorisation de récupérer le paquet nécessaire. Une fois le processus démarré, ouvre http://localhost:5678 dans ton navigateur. « Localhost » désigne ici l’ordinateur qui exécute n8n : cette adresse n’est pas automatiquement accessible depuis le téléphone d’un collègue ou depuis Internet.

Sur Windows, une erreur liée à Node.js se règle souvent en contrôlant le chemin d’installation et en redémarrant le terminal après la mise en place du logiciel. Sur macOS et Linux, la présence de plusieurs installations de Node.js peut aussi créer une confusion : la commande which node sur les systèmes Unix, ou where.exe node dans PowerShell, aide à repérer le programme utilisé.

Avec npx, l’installation est pratique, mais elle n’équivaut pas à un service permanent. Si Mina ferme la fenêtre du terminal ou éteint son ordinateur, son instance s’arrête. Ses tests ne doivent donc pas devenir par accident le seul moteur d’un processus commercial, par exemple l’envoi quotidien d’un récapitulatif des commandes.

Garde également en tête que les services externes ne peuvent pas appeler directement l’adresse localhost de ton ordinateur. Pour tester un webhook depuis un service tiers, il faut prévoir un accès temporaire ou une configuration réseau adaptée. Le mode tunnel peut dépanner pendant un essai, mais il ne remplace pas une exposition durable correctement sécurisée.

Installer n8n avec Docker et garder les workflows

Pour une instance qui doit survivre à l’arrêt et au remplacement du conteneur, Docker est généralement le choix le plus net. Le conteneur isole l’application de nombreux détails de l’ordinateur hôte, et un volume nommé peut conserver les données lorsque le conteneur est recréé. Docker ne prend toutefois pas en charge l’administration à ta place.

Sur Windows, installe Docker Desktop et vérifie que WSL2 est activé si ta configuration l’exige. Sur macOS, Docker Desktop fournit une interface graphique et le moteur nécessaire. Sur Linux, Docker Engine est une option courante ; dans tous les cas, vérifie que la commande docker fonctionne dans le terminal avant de continuer.

Crée d’abord le volume de données :

docker volume create n8n_data

Puis lance le conteneur avec le port 5678 publié et le volume monté au bon emplacement :

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

Quand le démarrage est terminé, l’interface est accessible à http://localhost:5678. La commande fournie utilise --rm : à l’arrêt du conteneur, Docker le supprime. Le volume n8n_data, lui, reste présent et contient les données enregistrées dans son répertoire de montage. Pour un usage régulier, il faut choisir un mode de lancement adapté à son fonctionnement, plutôt que de dépendre d’un terminal laissé ouvert.

Le volume n’est pas une sauvegarde. Il protège les données lors de la recréation du conteneur, mais ne met pas à l’abri d’une panne du disque, d’une suppression accidentelle ou d’un incident sur la machine. Mina devrait donc prévoir une copie de ses données sur un support distinct et vérifier qu’elle peut la restaurer. Une sauvegarde jamais testée ressemble beaucoup à une porte de secours dessinée sur un plan.

Lors d’une mise à jour, Docker récupère l’image récente avec docker pull docker.n8n.io/n8nio/n8n, puis le conteneur doit être recréé avec le volume conservé. Ne remplace pas l’image en oubliant le montage du volume : tu retrouverais une instance vide en apparence, alors que les données existent toujours ailleurs.

Docker apporte un environnement reproductible et une séparation pratique entre l’application et le système. Pour comprendre ce que cette isolation change, ce dossier présente les avantages des conteneurs Docker. Le point à retenir est simple : un conteneur facilite le déploiement, il ne supprime ni les sauvegardes ni les mises à jour.

Faire la configuration de n8n et tester son premier workflow

Quand l’interface s’ouvre pour la première fois, n8n demande de configurer le compte propriétaire. Choisis une adresse utilisée par la personne qui administrera l’instance et un mot de passe robuste. Même si n8n n’est accessible que depuis le même ordinateur au départ, ces identifiants ne sont pas un détail : une instance peut ensuite être exposée par erreur ou déplacée sur un serveur.

La configuration de n8n doit ensuite rester proportionnée au test. Mina peut commencer avec un déclencheur manuel, puis ajouter une action qui envoie des données vers un service de test. Elle vérifie les champs transmis, les résultats de chaque nœud et les erreurs éventuelles avant de relier l’automatisation à un vrai formulaire de commandes.

Un workflow se construit en reliant des nœuds sur le canevas. Un nœud de déclenchement démarre le processus, par exemple à la demande ou selon une programmation ; d’autres nœuds transmettent ou transforment les données. Pour une première prise en main, mieux vaut suivre un flux court et compréhensible que de brancher immédiatement plusieurs services sensibles.

• Commence avec des données fictives ou non sensibles.
• Exécute le workflow manuellement et vérifie les sorties de chaque étape.
• Contrôle les autorisations accordées aux comptes connectés.
• Active le workflow seulement après avoir testé les cas d’erreur les plus probables.

Les webhooks demandent une attention particulière. Un service comme un formulaire externe doit pouvoir joindre l’URL de n8n ; une adresse locale n’est pas accessible depuis l’extérieur. Pour un test ponctuel, un tunnel peut servir, mais une utilisation régulière nécessite une adresse joignable, du HTTPS et une configuration réseau maîtrisée.

Ne place pas des clés d’API directement dans des notes ou dans un document partagé. Utilise les mécanismes d’identifiants prévus dans n8n et limite les permissions au besoin réel. Si le workflow manipule des coordonnées de clients, teste aussi ce qui est enregistré dans l’historique d’exécution et qui peut consulter ces informations.

La licence Community Edition et les fonctions disponibles dépendent de l’offre et de la version utilisée. Consulte les réglages de l’instance et la documentation correspondant à ta version, plutôt que de supposer qu’une ancienne capture d’écran décrit encore l’interface actuelle. Pour Mina, le test réussi n’est pas seulement un workflow qui s’exécute : c’est un processus dont elle comprend les données et les accès.

Maintenir n8n en local et décider qui l’administre

Une instance locale devient utile quand elle rend un service régulier, mais elle crée aussi une responsabilité. Quelqu’un doit suivre les mises à jour de sécurité, vérifier que les workflows tournent, surveiller l’espace disque et conserver des sauvegardes exploitables. Ce rôle peut être tenu en interne, confié à un prestataire ou évité en choisissant n8n Cloud.

La question est souvent absente des tutoriels, alors qu’elle décide du coût réel. Un abonnement Cloud est une dépense récurrente visible ; l’auto-hébergement consomme du temps, une machine et une compétence d’administration. Pour une petite structure, le temps passé à réparer une instance peut coûter davantage que le service hébergé, surtout si personne ne sait intervenir.

Avant de rendre n8n accessible depuis l’extérieur, prévois au minimum une connexion protégée et une configuration HTTPS. N’expose pas l’interface sur Internet sans authentification ni contrôle d’accès. Un reverse proxy ou un tunnel peut faire partie de l’architecture, mais son installation et sa maintenance doivent être comprises, pas copiées à l’aveugle dans un tutoriel.

Une routine raisonnable comprend une vérification périodique des mises à jour, une sauvegarde planifiée du volume et un essai de restauration. Elle comprend aussi un contrôle des exécutions échouées : un workflow peut continuer à exister dans l’interface tout en ayant cessé de rendre le service attendu. Mina devrait, par exemple, comparer régulièrement les commandes reçues dans son formulaire avec celles arrivées dans son tableau de suivi.

Pour choisir entre les approches, pose-toi ces questions :

• Les données doivent-elles rester sur une infrastructure contrôlée par l’entreprise ?
• Une personne sait-elle mettre à jour et restaurer une instance Docker ?
• Les automatisations doivent-elles fonctionner lorsque l’ordinateur local est éteint ?
• Le budget doit-il prendre la forme d’un abonnement ou de temps d’administration ?

Si personne ne peut administrer un conteneur, l’auto-hébergement n’est pas forcément impossible, mais il faut prévoir qui le fera. Le mauvais scénario, c’est l’instance lancée avec enthousiasme, puis oubliée jusqu’au jour où un workflow s’arrête ou où une mise à jour devient urgente. Une commande installe n8n ; un responsable, lui, fait vivre le service.

Comment installer n8n en local sans Docker ?

Installe une version compatible de Node.js, vérifie-la avec node -v, puis lance npx n8n dans un terminal. Ouvre ensuite http://localhost:5678. Cette méthode convient surtout aux essais et aux prototypes, car le processus dépend de la machine et de la session.

La commande npm install n8n -g est-elle encore recommandée ?

Non. La documentation indique que les installations npm globales sont dépréciées à partir de n8n 3.0. Pour un essai, privilégie npx ; pour une installation auto-hébergée durable, examine la méthode Docker et les consignes officielles correspondant à ta version.

Comment conserver les workflows avec Docker ?

Monte un volume Docker nommé sur /home/node/.n8n, comme dans l’exemple avec n8n_data. Le volume conserve les données quand le conteneur est supprimé, mais il ne remplace pas une sauvegarde indépendante ni un test de restauration.

Peut-on recevoir des webhooks sur une installation locale ?

Pas directement depuis Internet avec une adresse localhost. Pour un essai, un tunnel peut rendre l’instance joignable temporairement. Pour un usage régulier, configure un accès externe sécurisé avec HTTPS et prévois la maintenance de cette exposition.

Quelle méthode choisir sur Windows, macOS ou Linux ?

Pour découvrir l’interface, npx fonctionne sur les trois systèmes avec Node.js compatible. Pour conserver une instance, Docker est une option courante ; Windows utilise souvent Docker Desktop avec WSL2, macOS Docker Desktop et Linux Docker Engine. Le choix dépend surtout de la personne qui assurera l’administration.