Installer n8n en local avec Docker, puis sur un serveur

Pour installer n8n en local, installez Docker, lancez curl -fsSL https://get.n8n.io | sh dans un terminal, puis ouvrez http://localhost:5678 : la documentation de n8n présente cette commande comme la voie la plus rapide. npx n8n fonctionne encore sur n8n 2.x, mais la documentation déclare les installations npm dépréciées à partir de n8n 3.0. Sur un serveur, la même base Docker reçoit en plus un nom de domaine et le HTTPS.

n8n Cloud, n8n local ou serveur : que choisir ?

n8n Cloud convient pour apprendre sans rien installer, l’installation locale pour tester gratuitement sur votre ordinateur. Le serveur devient utile quand vos workflows doivent tourner en continu ou que vos données doivent rester chez vous.

Option	Pour qui	Ce qu’il faut savoir faire	Ce qui reste à votre charge
n8n Cloud	Débuter, ou produire sans gérer d’infrastructure	Créer un compte	Vos workflows et l’abonnement
Installation locale	Tester et apprendre sur votre ordinateur	Installer Docker, lancer une commande dans un terminal	Les mises à jour, et un ordinateur allumé pour que les workflows tournent
Serveur auto-hébergé	Faire tourner des workflows en continu, garder vos données chez vous	Administrer un serveur Linux et des conteneurs, régler le DNS et le HTTPS, sécuriser l’accès	Mises à jour, sauvegardes, sécurité et disponibilité

La version que vous installez vous-même est la Community Edition, gratuite : sans clé de licence, n8n donne accès à presque toutes ses fonctionnalités. La documentation conseille l’auto-hébergement aux utilisateurs expérimentés, parce qu’une erreur de configuration peut coûter des données ou ouvrir une faille.

Si vous préférez ne rien installer, n8n Cloud s’essaie gratuitement pendant 14 jours. Le guide des prix de n8n détaille les tarifs du Cloud et le coût d’un auto-hébergement, et n8n, c’est quoi présente l’outil si vous le découvrez.

Installer n8n en local avec Docker

Avec Docker installé et démarré, une commande installe n8n et le rend disponible sur http://localhost:5678.

1. Installez Docker. Docker Desktop existe pour Mac, Windows et Linux, et inclut Docker Compose, dont la commande a besoin.

2. Dans un terminal, lancez la commande d’installation en une ligne :

   curl -fsSL https://get.n8n.io | sh

3. Attendez la ligne n8n is running at: http://localhost:5678, puis ouvrez cette adresse dans votre navigateur. Le premier démarrage prend quelques minutes.

Le script vérifie que Docker tourne, crée un dossier n8n dans le dossier courant, y écrit ses fichiers de configuration, dont compose.yml et .env, puis télécharge et démarre n8n. Vos données vont dans le volume Docker n8n-data. Le script prépare aussi les services de n8n Assistant, l’assistant IA de l’éditeur, qui reste éteint tant que vous n’ajoutez pas la clé d’un fournisseur d’IA.

Sous Windows, lancez la commande depuis WSL, avec l’intégration WSL2 de Docker Desktop activée : l’invite de commandes et PowerShell ne lisent pas les scripts shell.

Pour arrêter n8n, puis le relancer :

docker compose -f ./n8n/compose.yml down
docker compose -f ./n8n/compose.yml up -d

La commande docker run, avec son volume et son port

La page Install with Docker donne la commande minimale. n8n la signale comme dépassée et renvoie vers Docker Compose, mais elle reste la plus lisible pour comprendre ce que fait le conteneur :

docker volume create n8n_data

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

Remplacez <YOUR_TIMEZONE> par Europe/Paris.

Réglage	Valeur	Ce qu’il fait
Image	n8nio/n8n	L’image que Docker télécharge
Port	-p 5678:5678	n8n répond sur http://localhost:5678
Volume	n8n_data, monté sur /home/node/.n8n	Vos données survivent au redémarrage du conteneur
Fuseau horaire	GENERIC_TIMEZONE et TZ	L’heure des déclencheurs planifiés, et celle du système

Le dossier .n8n contient la base SQLite et la clé qui chiffre vos identifiants : c’est lui qu’une sauvegarde doit conserver. Sans réglage, GENERIC_TIMEZONE vaut America/New_York ; le guide n8n en français montre l’effet sur un workflow planifié.

Installer n8n avec npx ou npm : une méthode en fin de vie

Avec Node.js entre les versions 20.19 et 24.x, npx n8n télécharge n8n et le démarre sur http://localhost:5678, sans installation. La méthode fonctionne sur n8n 2.x ; n8n annonce sa fin pour la version 3.0.

npx n8n

Pour l’installer durablement, puis le lancer :

npm install n8n -g
n8n start

La page npm de la documentation porte deux avertissements :

• « npm-based installs are deprecated from n8n 3.0 ». La page de la commande en une ligne ajoute que npx n8n et npm install n8n cessent de fonctionner à cette version.
• n8n Assistant indisponible. L’assistant IA de l’éditeur ne s’active pas sur une installation npm.

Vos données se rangent dans le dossier ~/.n8n. Pour un test d’une heure, npx fait l’affaire ; pour une installation que vous comptez garder, partez sur Docker.

Webhooks sur un n8n local : ce qui fonctionne

Sur une installation locale, n8n n’est joignable que depuis votre ordinateur : un service en ligne ne peut pas appeler http://localhost:5678, et ses webhooks n’arrivent jamais.

n8n compose l’adresse de ses webhooks avec les variables N8N_PROTOCOL, N8N_HOST et N8N_PORT, qui valent par défaut http, localhost et 5678. D’après la documentation, les triggers de services externes comme GitHub exigent un n8n joignable depuis le web.

Déclencheur	Sur un n8n local
Exécution manuelle, Schedule Trigger	Fonctionne : n8n prend l’initiative
Nœud Webhook appelé depuis votre ordinateur	Fonctionne sur http://localhost:5678
Nœud Webhook appelé par un service en ligne	Demande une adresse publique
Trigger d’application fondé sur un webhook	Demande une adresse publique

Pour exposer une instance locale, la documentation décrit un tunnel fondé sur cloudflared, qui redirige les requêtes du web vers votre n8n. Elle le réserve au développement et aux tests, et prévient que son fonctionnement peut changer d’une version à l’autre. L’option --tunnel des anciens tutoriels a disparu avec n8n 2.0.

Pour recevoir des webhooks de façon durable, il faut n8n Cloud ou un serveur avec un nom de domaine. Le guide des webhooks n8n détaille ensuite les URL de test et de production.

n8n self-hosted sur un serveur : ce que Docker Compose ajoute

Sur un serveur, un fichier Docker Compose décrit n8n et le reverse proxy qui le publie en HTTPS sur votre nom de domaine. La documentation fournit ce fichier, et la marche à suivre complète, pour un serveur Linux avec Docker Compose.

Ce qui s’ajoute	Ce que prévoit la documentation
Un nom de domaine	Un sous-domaine, relié à l’adresse IP du serveur par un enregistrement DNS de type A
Le HTTPS	Un reverse proxy, Traefik dans l’exemple, qui gère les certificats TLS
Des variables d’environnement	Hôte, protocole, adresse des webhooks et fuseau horaire
Une base de données	PostgreSQL à la place de SQLite pour une instance de production
Des sauvegardes	Le dossier .n8n : sans la clé de chiffrement qu’il contient, une base restaurée ne déchiffre plus vos identifiants

Le fichier .env de l’exemple déclare quatre variables :

DOMAIN_NAME=example.com
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Europe/Berlin
SSL_EMAIL=user@example.com

Elles alimentent l’environnement du service n8n dans compose.yaml :

- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- NODE_ENV=production
- N8N_WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
- N8N_RESTRICT_FILE_ACCESS_TO=/files

Avec GENERIC_TIMEZONE=Europe/Paris, vos workflows planifiés partent à l’heure française. N8N_WEBHOOK_URL donne à n8n l’adresse publique de ses webhooks : sans elle, n8n la compose avec son port interne 5678, alors que le proxy l’expose sur le port 443.

VPS n8n et offres « n8n en un clic » : Hostinger et autres hébergeurs

Une offre « n8n en un clic » est un VPS livré avec n8n déjà installé : l’hébergeur fait l’installation à votre place, et l’instance reste auto-hébergée. Hostinger, souvent cherché avec n8n, vend ce type de VPS à partir d’un modèle de serveur préinstallé.

Avant de souscrire, quel que soit l’hébergeur, vérifiez quatre points sur la page de l’offre :

• Les mises à jour de n8n : qui les lance ? La documentation en conseille au moins une par mois.
• Les sauvegardes du dossier .n8n : qui les fait, et comment les restaurer.
• Le nom de domaine et le HTTPS, indispensables aux webhooks.
• La mémoire : au moins 4 Go de RAM et 2 vCPU si vous activez n8n Assistant.

Mettre à jour n8n

Chaque méthode d’installation a sa commande de mise à jour, et vos données restent dans leur volume Docker ou dans le dossier .n8n.

# Installation par la commande en une ligne
curl -fsSL https://get.n8n.io | sh -s -- --upgrade

# Docker Compose, depuis le dossier du fichier compose
docker compose pull
docker compose down
docker compose up -d

# docker run : récupérer la nouvelle image, puis relancer le conteneur
docker pull n8nio/n8n

# npm
npm update -g n8n

La documentation conseille de mettre à jour au moins une fois par mois, pour éviter de sauter plusieurs versions d’un coup, et de lire les notes de version avant chaque mise à jour. Une version majeure peut changer des réglages par défaut, comme l’a fait n8n 2.0.

Après l’installation : votre premier workflow

À la première ouverture, n8n vous fait créer le compte propriétaire de l’instance. Pour la suite :

• Le tutoriel n8n pour débutant monte un premier workflow. En auto-hébergé, connecter Google demande de créer une application dans Google Cloud Console.
• Les templates n8n indiquent où trouver des workflows prêts à adapter.
• La gestion d’erreurs met en place l’alerte qui vous prévient quand un workflow échoue.
• Le hub n8n regroupe les autres guides, et n8n ou Make compare les deux outils.

FAQ

Peut-on installer n8n gratuitement ?

Oui. Sans clé de licence, n8n tourne en Community Edition, gratuite et dotée de presque toutes les fonctionnalités. Restent à votre charge le serveur, si vous en louez un, et le temps de maintenance.

Faut-il Docker pour installer n8n ?

Pas sur n8n 2.x : npx n8n suffit, avec Node.js entre les versions 20.19 et 24.x. La documentation annonce la fin de cette méthode avec n8n 3.0, et sa commande d’installation en une ligne repose sur Docker.

Quelle configuration minimale pour n8n ?

La documentation ne donne pas de minimum général pour n8n seul. Elle demande Node.js entre 20.19 et 24.x pour npm, et au moins 4 Go de RAM et 2 vCPU pour l’installation Docker Compose qui embarque le bac à sable de n8n Assistant.

Pourquoi mes webhooks ne marchent pas en local ?

L’adresse localhost n’existe que sur votre ordinateur, et un service en ligne ne peut pas l’appeler. Il faut une adresse publique : n8n Cloud, un serveur avec un nom de domaine, ou un tunnel le temps d’un test.

Comment mettre à jour n8n avec Docker ?

Avec Docker Compose, lancez docker compose pull, docker compose down, puis docker compose up -d depuis le dossier du fichier compose. Si vous avez installé n8n par la commande en une ligne, relancez-la avec l’option --upgrade.

n8n Cloud ou auto-hébergé : lequel choisir pour débuter ?

n8n Cloud, qui s’utilise sans installation et s’essaie gratuitement pendant 14 jours. La documentation de n8n le recommande elle-même à qui n’a pas l’habitude d’administrer un serveur ; l’installation locale reste un bon terrain d’essai gratuit.

---

Ma formation n8n commence une fois n8n ouvert : 31 leçons vidéo en 4 chapitres pour apprendre à construire des workflows, des fondations à la transformation des données et au contrôle du flux. L’installation d’un serveur n’en fait pas partie.

Sources : n8n Docs · installation en une ligne, n8n Docs · installation avec Docker, n8n Docs · installation avec npm, n8n Docs · Docker Compose sur un serveur, ainsi que les pages « Update n8n », « Back up and restore », « Configure webhook URLs with reverse proxy », « Compare editions » et « Release notes » de la documentation n8n.