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.

InstallerÉditeurWebhook

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.

5678
Port éditeur par défaut
2 voies
Installs officiels de départ
Webhook
Premier workflow
MéthodePrérequisQuand
DockerDocker EngineVolume nommé, facile à jeter
npx / npmNode LTS supportéPas de conteneur, juste l’éditeur
n8n CloudInscription navigateurPas de process local ; hors sujet ici

Cinq étapes jusqu’au Webhook

  1. 1

    Démarrer Docker ou npm

    Docker : docker volume create n8n_data, puis docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n. Node : npx n8n dans un dossier vide, ou install global plus n8n start. Les tags bougent — revoyez docs.n8n.io.

  2. 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. 3

    Nouveau workflow, nœud Webhook

    New workflow. Nœud Webhook. HTTP Method POST. Path aléatoire ou hello. Pas encore de secrets de prod.

  4. 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. 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:5678

Trois pièces d’éditeur d’abord

01

Toile et nœuds

Chaque nœud est une étape : déclencheur, transform, sortie. Webhook est un déclencheur. Panneau droit : method, path, auth.

02

URL de test vs production

Le test ne vit que pendant Listen. La prod exige Active. Les mélanger : 404 ou vide.

03

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.

Démarrer une réunion gratuite