Installer n8n en local avec Docker

$ docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
Editor is now accessible via: http://localhost:5678

En local, avant de te lancer

Ce tuto installe n8n sur ta machine, pas sur un serveur. C'est le bon move pour apprendre, prototyper, tester des workflows sans rien payer. Ce n'est pas le bon move pour tout. Mets ça au clair avant de commencer :

Besoin que ça tourne 24/7, que ça reçoive des webhooks externes, ou que plusieurs personnes y touchent en même temps ? C'est le signal qu'il te faut un serveur (VPS), pas ce setup. On garde ça pour un autre tuto.

À la fin de ce tuto, tu sais

• Ce qu'est Docker, et pourquoi c'est la méthode reco pour n8n
• Installer Docker Desktop sur ta machine
• Créer un volume pour ne jamais perdre tes workflows
• Lancer n8n avec une seule commande
• Accéder à n8n depuis ton navigateur
• Démarrer / arrêter n8n au quotidien, sans y réfléchir
• Mettre à jour n8n sans casser tes données

Pourquoi Docker, et pas une install classique

n8n s'installe de plusieurs façons. Docker, c'est la méthode que l'équipe recommande officiellement. Et honnêtement, c'est aussi la plus simple à comprendre une fois que t'as capté le principe.

Docker fait tourner n8n dans une boîte isolée, tout ce dont n8n a besoin est dedans. Zéro dépendance à installer à la main, zéro conflit de versions, zéro "ça marche chez moi mais pas chez toi". La même commande tourne sur Windows, Mac, Linux. Sans rien changer.

L'image, c'est la recette. Le conteneur, c'est le gâteau.

01 · Installer Docker Desktop

Docker Desktop, c'est l'appli qui fait tourner Docker chez toi. Installation classique, comme n'importe quel logiciel.

Windows

Va sur docker.com/products/docker-desktop (nouvel onglet), télécharge la version Windows, lance le fichier. Pendant l'install, laisse coché WSL 2, c'est la config recommandée. Redémarre si on te le demande, puis lance Docker Desktop depuis le menu Démarrer. Une baleine apparaît dans la barre des tâches : attends qu'elle soit stable.

WSL 2 = Windows Subsystem for Linux. Un noyau Linux qui tourne dans Windows, utilisé en arrière-plan par Docker. Tu n'as rien à gérer directement.

Mac

Même page, télécharge la bonne version : Apple Silicon (M1/M2/M3) ou Intel. Pour vérifier ta puce → Pomme > À propos de ce Mac. Ouvre le .dmg, glisse Docker dans Applications, lance-le. La baleine apparaît en haut à droite. Attends qu'elle soit stable.

Linux (Ubuntu / Debian)

Ça se passe dans le terminal :

sudo apt update
sudo apt install -y ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

sudo usermod -aG docker $USER
newgrp docker

Vérifie l'install, tous systèmes confondus :

$ docker --version
Docker version 24.0.5

Sur Windows et Mac, Docker Desktop doit tourner en arrière-plan pour que les commandes fonctionnent. Fermé = les commandes échouent.

02 · Créer le volume de données

Avant de lancer n8n, tu crées le volume qui va stocker tes données. Une seule fois, jamais deux.

$ docker volume create n8n_data
n8n_data

Docker te renvoie n8n_data : c'est la confirmation. Ce volume survit à toutes les mises à jour, tous les redémarrages de conteneur. Tes workflows y restent, point.

03 · Lancer n8n

C'est parti. Une seule commande :

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

Premier lancement : Docker télécharge l'image, ça prend quelques minutes selon ta connexion. Ensuite, ce sera instantané. Tu sais que c'est bon quand tu vois :

Editor is now accessible via: http://localhost:5678

Ouvre http://localhost:5678 (nouvel onglet) dans ton navigateur. Au premier lancement, n8n te demande de créer un compte local, stocké uniquement chez toi, dans le volume.

localhost = ton propre ordinateur. 5678 = le port, il identifie n8n parmi tout ce qui tourne sur ta machine. Toujours la même adresse en local.

Tant que n8n tourne, laisse le terminal ouvert. Pour arrêter : Ctrl + C.

Le quotidien

Démarrer :

1. Ouvre Docker Desktop, attends que la baleine soit stable (Windows / Mac)
2. Ouvre un terminal
3. Lance la commande docker run
4. Attends le message Editor is now accessible
5. Ouvre http://localhost:5678 (nouvel onglet)

Arrêter : retourne dans le terminal, Ctrl + C. Le conteneur s'arrête, tes workflows restent dans le volume.

Se simplifier la vie : la commande est longue à retaper à chaque fois. Sur Mac / Linux, crée un alias :

echo "alias n8n='docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n'" >> ~/.zshrc
source ~/.zshrc

Tu utilises bash plutôt que zsh ? Remplace ~/.zshrc par ~/.bashrc.

Ensuite, tape juste n8n dans le terminal. Fini les copier-coller.

Sur Windows : crée un fichier lancer-n8n.bat sur ton bureau, avec ce contenu, et double-clique dessus :

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

Mettre à jour n8n

Arrête n8n s'il tourne, télécharge la nouvelle image, relance. Tes données ne bougent pas.

docker pull docker.n8n.io/n8nio/n8n

Relance ensuite avec ta commande habituelle. Docker prend la nouvelle image automatiquement.

Les erreurs classiques

Check final

Avant de passer à la suite, vérifie que tout tient debout :

• Lance n8n, va sur http://localhost:5678 (nouvel onglet)
• Crée un workflow, donne-lui un nom, sauvegarde
• Arrête avec Ctrl + C
• Relance la même commande
• Retourne sur localhost:5678, ton workflow doit être là

Workflow toujours là ? Ton install est bonne, le volume fait son job. Tu peux construire sans risquer de perdre quoi que ce soit.

Workflow disparu ? Le volume n'est pas bien attaché. Vérifie que ta commande contient bien -v n8n_data:/home/node/.n8n, et que le volume existe avec docker volume ls.

Toutes les commandes, résumées

Bonnes pratiques

L'install qui tourne, c'est une chose. La faire durer sans mauvaise surprise, c'en est une autre. Quelques réflexes à prendre.

Coupe n8n quand tu ne l'utilises pas

Avec la commande -it --rm, n8n ne tourne que quand ton terminal est ouvert, pas de service qui tourne en tâche de fond 24/7 sur ta machine. Ferme-le en fin de session, comme n'importe quelle appli lourde.

Nuance importante : les Schedule Trigger et les webhooks ne se déclenchent que si n8n tourne au moment prévu. Un workflow programmé à 9h ne partira pas si ton n8n local est éteint à 9h. Pour de l'automatisation qui doit tourner sans toi, il faut un hébergement distant, pas ce setup local.

Sauvegarde le volume, pas juste tes workflows

Le dossier /home/node/.n8n contient aussi ta clé de chiffrement, celle qui protège tes credentials. Si elle disparaît ou change, tous tes identifiants stockés deviennent illisibles, même si les workflows sont toujours là.

# pendant que le conteneur tourne
docker cp n8n:/home/node/.n8n ./backup-n8n-$(date +%Y%m%d)

Une copie de temps en temps, sur un disque externe ou un cloud perso, et tu ne repars jamais de zéro.

Mets à jour régulièrement, mais pas les yeux fermés

n8n sort une nouvelle version quasiment chaque semaine. Utile pour les nouveautés, risqué si tu casses un workflow en prod perso sans t'en rendre compte. Avant un docker pull, jette un œil au changelog. Et si un workflow est critique, teste la mise à jour avant de l'appliquer partout.

Configure ton fuseau horaire dès le départ

Sans ça, tes Schedule Trigger peuvent se déclencher à la mauvaise heure. Ajoute ces deux variables à ta commande docker run :

-e GENERIC_TIMEZONE="Europe/Paris" -e TZ="Europe/Paris"

GENERIC_TIMEZONE pilote les nodes programmés (Schedule Trigger). TZ règle l'heure système du conteneur. Les deux, sinon ça se contredit.

Le tunnel webhook, c'est du dev only

n8n propose un service de tunnel (via cloudflared) pour recevoir des webhooks externes, GitHub, Stripe, etc., sur ton instance locale. Pratique pour tester. Mais l'implémentation change d'une version à l'autre, et ce n'est pas fait pour tourner en continu. Pour un usage stable, il faut une vraie instance hébergée, joignable depuis internet.

SQLite en local, très bien, jusqu'à un certain point

Par défaut, n8n stocke tout dans une base SQLite, dans le volume. Largement suffisant pour un usage perso ou des tests. Si tu montes en charge (beaucoup de workflows, exécutions fréquentes, plusieurs personnes), c'est le signe qu'il est temps de passer à PostgreSQL et à une vraie instance, plus dans le scope de ce tuto local.

Travailler à plusieurs en local

Question qui revient vite : "comment je fais si un collègue bosse sur les mêmes workflows ?" Réponse courte : en édition Community (ce qu'on installe dans ce tuto), il n'y a pas de vraie collab native. Voici ce qui existe réellement.

La méthode manuelle, celle qui coûte rien :

# chacun de son côté
n8n export:workflow --all --output=./backups/
# puis commit + push dans un repo Git partagé
git add backups/ && git commit -m "update workflows" && git push

Basique, pas de merge automatique, pas de review façon pull request dans n8n lui-même, mais ça donne un historique de versions et un point de partage commun, sans sortir la carte bleue.

Pour une vraie collab à plusieurs, en simultané : deux options honnêtes. Un plan Business/Enterprise (self-hosted ou Cloud) pour le partage natif avec permissions, ou une instance hébergée à distance sur laquelle tout le monde se connecte, donc plus vraiment "en local". Ce tuto reste pensé pour un poste perso ; au-delà, c'est un autre sujet.

Questions de pros

Passé un moment, ce setup local montre ses limites. Voici les questions qui reviennent le plus chez les gens qui poussent n8n plus loin, et où ça les mène.

n8n × Docker, installation locale · un tuto, pas un roman.