Installer n8n en local : Docker ou npm, premier Webhook
Démarrez n8n avec Docker ou npx, ouvrez le port 5678, posez un nœud Webhook, recevez la première requête sur l’URL de test.
Inutile d’un siège cloud pour brancher une requête HTTP. n8n tourne en local : éditeur dans le navigateur, données ici par défaut.
Suivez la doc et installez n8n en local avec Docker ou npm, ouvrez localhost:5678, puis le premier Webhook. Guide outils développeur, pas un mode d’emploi brainstorm.
Choisir une voie d’install
Voir docs.n8n.io/hosting/installation. Pour un essai laptop : Docker ou Node. Postgres et file d’attente plus tard.
| Méthode | Prérequis | Quand |
|---|---|---|
| Docker | Docker Engine | Volume nommé, facile à jeter |
| npx / npm | Node LTS supporté | Pas de conteneur, juste l’éditeur |
| n8n Cloud | Inscription navigateur | Pas de process local ; hors sujet ici |
Cinq étapes jusqu’au Webhook
- 1
Démarrer Docker ou npm
Docker :
docker volume create n8n_data, puisdocker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n. Node :npx n8ndans un dossier vide, ou install global plusn8n start. Les tags bougent — revoyez docs.n8n.io. - 2
Ouvrir l’éditeur, créer l’owner
http://localhost:5678. Premier chargement : e-mail et mot de passe. Cet utilisateur possède l’instance, pas un plan cloud. On peut sauter l’assistant et rester sur une toile vide. - 3
Nouveau workflow, nœud Webhook
New workflow. Nœud Webhook. HTTP Method
POST. Path aléatoire ouhello. Pas encore de secrets de prod. - 4
Listen et curl sur l’URL de test
Listen for test event, copier l’URL de test. Autre terminal :
curl -X POST URL_TEST -H 'Content-Type: application/json' -d '{"ping":true}'. Listen s’arrête, le JSON apparaît. - 5
Répondre, puis décider d’Activate
Set ou Respond to Webhook avec
{"ok":true}. Sur le laptop, rester sur l’URL de test. URL stable : enregistrer, Activate, Production URL. 5678 n’est pas public.
docker volume create n8n_data
docker run -it --rm --name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n
# ou : npx n8n
# puis http://localhost:5678Trois pièces d’éditeur d’abord
Toile et nœuds
Chaque nœud est une étape : déclencheur, transform, sortie. Webhook est un déclencheur. Panneau droit : method, path, auth.
URL de test vs production
Le test ne vit que pendant Listen. La prod exige Active. Les mélanger : 404 ou vide.
Identifiants et env
Clés tierces dans Credentials, pas dans les champs. Config sous .n8n. Ne pas committer ce dossier.
Pièges fréquents
Port pris : -p 5679:5678 ou arrêter l’ancien conteneur. Volume Docker obligatoire, sinon --rm efface les workflows. Un vieux Node fait échouer npx n8n — LTS supporté.
Quand le flux marche et qu’il faut un croquis : wbstorm est un identifiant de salle — créer ou rejoindre une salle, bases du tableau, écrire des Cursor Rules.
Docker est-il obligatoire ?
Non. La doc couvre aussi npm. npx est plus vite pour l’éditeur seul. Docker plus volume nommé si l’instance doit être jetable.
Pourquoi 404 sur l’URL de test ?
Onglet ouvert et nœud en Listen. Onglet fermé ou Listen oublié : l’URL de test n’accepte rien.
C’est n8n Cloud ?
L’éditeur se ressemble. Hébergement et facturation non. Cloud n’utilise pas votre port local. Cet article = auto-hébergé sur localhost.
Est-ce une fonction wbstorm ?
Non. Seulement n8n en local et un Webhook. wbstorm est une salle de brainstorm dans le navigateur, sans lien avec le runtime d’automatisation.