Installer n8n en local : Windows, Mac ou Linux, avec npx, npm ou Docker Desktop

Pour installer n8n en local, le plus court est npx n8n avec Node.js 20.19 à 24.x, puis d'ouvrir http://localhost:5678 ; pour une installation qui dure, lancez l'image officielle dans Docker Desktop (Windows, Mac ou Linux) avec un volume nommé pour garder vos workflows. Les deux méthodes donnent le même éditeur et la même Community Edition gratuite, sans quota d'exécutions. Ce guide donne les commandes exactes de la documentation officielle (vérifiées le 14 octobre 2026), dit où vos données sont rangées, et ce qui change le jour où le workflow doit tourner sans votre ordinateur.

Quelle méthode choisir en local

Méthode	Prérequis	Pour qui	Point faible
npx n8n	Node.js 20.19 à 24.x	essayer n8n en deux minutes	dépend de la version de Node.js installée
npm install n8n -g	Node.js 20.19 à 24.x	usage régulier sans Docker	mises à jour et version de Node.js à surveiller
Docker Desktop	Docker Desktop (Mac, Windows, Linux)	installation durable, proche d'un serveur	un logiciel de plus à installer

Sur Windows, la documentation renvoie au guide Microsoft d'installation de Node.js en cas de problème : la plupart des échecs de npx n8n viennent d'une version de Node.js hors de la plage prise en charge. Vérifiez-la avant tout avec node -v.

Méthode 1 : npx ou npm (Windows, Mac, Linux)

# Vérifier la version de Node.js (attendu : 20.19 à 24.x)
node -v

# Essayer sans rien installer
npx n8n

# Ou installer n8n durablement, puis le lancer
npm install n8n -g
n8n start

L'éditeur répond sur http://localhost:5678. Au premier lancement, n8n demande de créer le compte propriétaire de l'instance. Pour mettre à jour une installation npm : npm update -g n8n.

Méthode 2 : Docker Desktop

Installez Docker Desktop, puis, dans un terminal (PowerShell sur Windows, en remplaçant les \ de fin de ligne par des accents graves `) :

docker volume create n8n_data

docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e GENERIC_TIMEZONE="Europe/Paris" \
 -e TZ="Europe/Paris" \
 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
 -v n8n_data:/home/node/.n8n \
 n8nio/n8n

C'est la commande de la documentation Docker de n8n, avec le fuseau de Paris. GENERIC_TIMEZONE règle l'heure des nodes planifiés comme le Schedule Trigger ; sans lui, un workflow « tous les jours à 8 h » peut partir à la mauvaise heure (détails dans notre guide sur le Schedule Trigger et les fuseaux horaires). L'option --rm supprime le conteneur à l'arrêt, mais pas le volume n8n_data : vos workflows sont conservés d'un lancement à l'autre.

Si un workflow lancé dans Docker doit joindre un service de votre machine (une base locale, Ollama), localhost désigne le conteneur, pas votre ordinateur : c'est l'erreur ECONNREFUSED traitée dans notre guide n8n Docker et localhost.

Où sont vos données (et pourquoi ça compte)

Par défaut, n8n enregistre workflows, credentials et historique d'exécutions dans une base SQLite, dans son dossier de données : ~/.n8n avec npm, le volume n8n_data (monté sur /home/node/.n8n) avec Docker. Ce dossier contient aussi la clé de chiffrement des credentials. Deux conséquences :

• supprimer le volume ou le dossier efface tout, workflows compris ;
• copier la base sans la clé ne suffit pas : les identifiants enregistrés (clés d'API, comptes OAuth) ne se déchiffrent plus ailleurs.

Ce qu'un n8n local ne fait pas

Une instance sur votre poste suffit pour apprendre, construire et tester. Elle s'arrête en revanche dès que l'ordinateur dort, et elle n'est pas joignable depuis Internet : un Schedule Trigger ne part pas machine éteinte, et Stripe, un CRM ou un formulaire ne peuvent pas appeler http://localhost:5678. Pour tester des webhooks, un tunnel suffit (voir tester des webhooks n8n en local) ; la documentation de n8n précise qu'il est réservé au développement et n'est pas sûr en production.

Du local au serveur

Quand un workflow doit tourner en continu, il passe sur un serveur. Les commandes de la CLI n8n exportent tout depuis l'instance locale :

n8n export:workflow --all --output=workflows.json
n8n export:credentials --all --decrypted --output=credentials.json
# Avec Docker : préfixer par docker exec -u node -it n8n

Puis, sur le serveur, n8n import:workflow --input=workflows.json et n8n import:credentials --input=credentials.json. Le fichier de credentials déchiffrés contient vos secrets en clair : transférez-le par un canal sûr et supprimez-le ensuite. Le même principe sert pour migrer depuis n8n Cloud.

Côté serveur, la base passe de SQLite à PostgreSQL, et il faut ajouter HTTPS, sauvegardes testées et mises à jour : c'est l'objet de notre guide installer n8n avec Docker Compose et PostgreSQL. Si vous préférez une pile déjà éprouvée, le Kit Auto-hébergement FlowKit (79 €, paiement unique) livre Docker Compose avec PostgreSQL 18, HTTPS automatique par Caddy, mode queue, scripts de sauvegarde chiffrée, de restauration et de mise à jour avec retour arrière, testés de bout en bout le 12 octobre 2026.

Premier workflow à importer

Pour vérifier que votre n8n local fonctionne avec un vrai cas, le tri d'e-mails par IA en IMAP ne demande que des nodes standards et une clé d'API de modèle : importez le JSON, branchez la boîte de test, lancez une exécution manuelle.