Comment installer n8n avec Docker en 5 minutes
Chapitres
Résumé
n8n est un outil d'automatisation open source qui s'installe en self-hosted via Docker en moins de 10 minutes. Cette méthode utilise Docker Compose avec une base PostgreSQL pour obtenir une instance locale complète, fonctionnelle hors connexion et arrêtable à la demande. Ce guide détaille chaque étape, de l'installation de Docker Desktop au premier accès à l'interface n8n.
Points clés
- Temps d'installation : environ 5 à 10 minutes selon la connexion internet
- Prérequis : Docker Desktop (Windows, Mac ou Linux) - gratuit
- Base de données : PostgreSQL incluse dans le Docker Compose officiel
- Accès local : http://localhost:5678
- Licence d'essai : 14 jours avec toutes les fonctionnalités (optionnel)
- Fonctionne hors connexion pour les workflows locaux
Installer Docker Desktop
Docker Desktop est le moteur de conteneurisation nécessaire pour faire tourner n8n en local. L'application est disponible gratuitement sur docs.docker.com/desktop pour Windows, macOS et Linux. Sous Windows, le téléchargement génère un installeur exécutable. Après installation, un redémarrage du système est requis. Au relancement, l'interface Docker Desktop doit s'ouvrir avec un tableau de bord vide, prêt à recevoir des conteneurs.
Télécharger le dépôt n8n Docker Compose
n8n fournit un dépôt GitHub officiel contenant les fichiers Docker Compose préconfigurés. La documentation se trouve sur docs.n8n.io/hosting/installation/docker. Depuis cette page, un lien renvoie vers le dépôt GitHub. Cliquer sur le bouton "Code" puis "Download ZIP" pour télécharger l'ensemble des fichiers. Après extraction du ZIP, naviguer dans le dossier docker-compose/withPostgres. Ce dossier contient quatre fichiers : le .env avec les identifiants par défaut, le docker-compose.yml qui décrit les services, et les fichiers de configuration PostgreSQL.
Configurer les variables d'environnement
Le fichier .env contient les identifiants de la base PostgreSQL (utilisateur, mot de passe) et les paramètres n8n. Pour un usage local de test, les valeurs par défaut sont suffisantes. En production, il est impératif de modifier les mots de passe par défaut. Les variables principales sont POSTGRES_USER, POSTGRES_PASSWORD et N8N_BASIC_AUTH_PASSWORD. Le fichier docker-compose.yml décrit deux services : PostgreSQL (base de données) et n8n (application). Aucune modification n'est nécessaire pour un premier lancement.
Lancer n8n avec Docker Compose
Ouvrir un terminal (invite de commandes sous Windows, Terminal sous macOS/Linux). Se déplacer dans le dossier withPostgres avec la commande cd suivie du chemin complet. Vérifier la présence des fichiers avec dir (Windows) ou ls (macOS/Linux). Lancer la commande :
docker compose up -dLe flag -d lance les conteneurs en arrière-plan (mode détaché). Le premier lancement télécharge les images Docker de PostgreSQL et n8n, ce qui prend quelques minutes selon la connexion. Les lancements suivants démarrent en 10 à 15 secondes. Une fois terminé, Docker Desktop affiche deux conteneurs avec des pastilles vertes : PostgreSQL et n8n.
Premier accès à l'interface n8n
n8n est accessible à l'adresse http://localhost:5678. Au premier lancement, un formulaire demande de créer un compte administrateur (nom, email, mot de passe). Une option permet de demander une licence d'essai de 14 jours activant toutes les fonctionnalités premium. Cette licence est envoyée par email et reste optionnelle - n8n Community fonctionne sans elle. Après la configuration initiale, l'interface de création de workflows s'ouvre.
Gérer l'instance : démarrer et arrêter n8n
L'un des avantages de Docker Desktop est la gestion visuelle des conteneurs. Pour arrêter n8n, sélectionner le projet dans Docker Desktop et cliquer sur "Stop". L'instance n'est plus accessible, mais les données persistent dans les volumes Docker. Pour relancer, sélectionner le projet et cliquer sur "Play" - le redémarrage prend 10 à 15 secondes. Cette approche évite que n8n consomme des ressources en permanence. Pour un arrêt en ligne de commande, utiliser docker compose down depuis le dossier du projet.
Generateur docker-compose.yml
Configurez les options ci-dessous. Les sections avancees sont depliables.
version: "3.8"
volumes:
db_storage:
n8n_storage:
services:
postgres:
image: postgres:16
restart: always
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=changeme
- POSTGRES_DB=n8n
volumes:
- db_storage:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -h localhost -U n8n -d n8n"]
interval: 5s
timeout: 5s
retries: 10
n8n:
image: docker.n8n.io/n8nio/n8n
restart: always
environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=changeme
- GENERIC_TIMEZONE=Europe/Paris
ports:
- "5678:5678"
depends_on:
postgres:
condition: service_healthy
volumes:
- n8n_storage:/home/node/.n8nContenu détaillé
00:00Introduction et prérequis
Ce tutoriel montre comment installer n8n en local avec Docker Compose et PostgreSQL. Trois étapes sont nécessaires : installer Docker Desktop, télécharger le dépôt officiel n8n depuis GitHub, et lancer l'instance avec une commande. L'installation fonctionne sur Windows, macOS et Linux. Le temps total est d'environ 5 à 10 minutes selon la vitesse de la connexion internet.
00:25Installer Docker Desktop
Docker Desktop s'installe depuis docs.docker.com/desktop. Sous Windows, le téléchargement fournit un exécutable .exe. L'installation suit un processus classique et requiert un redémarrage du système. Après redémarrage, l'application Docker Desktop apparaît dans les programmes et affiche un tableau de bord vide. L'application est aussi disponible pour macOS (Intel et Apple Silicon) et Linux (Ubuntu, Debian, Fedora).
01:15Télécharger le dépôt n8n
Le dépôt officiel se trouve sur GitHub via la documentation n8n (docs.n8n.io). Le lien Docker Compose dans la doc renvoie vers le repository GitHub contenant les fichiers de configuration. Télécharger le ZIP via le bouton Code > Download ZIP. Extraire l'archive et naviguer vers docker-compose/withPostgres qui contient les 4 fichiers nécessaires.
02:10Configurer les fichiers
Le fichier .env contient les identifiants de base (utilisateur PostgreSQL, mot de passe). Pour un test local, les valeurs par défaut fonctionnent. En production, modifier impérativement les mots de passe. Le fichier docker-compose.yml décrit deux services : PostgreSQL pour la base de données et n8n pour l'application. Aucune modification requise pour le premier lancement.
03:00Lancer n8n avec docker compose up
Ouvrir un terminal, naviguer vers le dossier withPostgres avec cd, vérifier les fichiers avec dir/ls, puis exécuter docker compose up -d. Le premier lancement télécharge les images (quelques minutes). Docker Desktop affiche ensuite deux conteneurs avec des pastilles vertes. n8n est accessible sur http://localhost:5678.
04:10Configuration initiale de l'interface
Au premier accès, n8n demande de créer un compte (nom, email, mot de passe). Une licence d'essai de 14 jours peut être demandée pour activer les fonctionnalités premium. Cette licence est optionnelle - n8n Community Edition fonctionne sans elle. Après la configuration, l'interface de création de workflows est accessible.
05:15Avantages et gestion start/stop
Docker Desktop permet d'arrêter et relancer n8n visuellement. Sélectionner le projet et cliquer Stop pour arrêter, Play pour relancer (10-15 secondes). Avantages principaux : fonctionnement hors connexion, installation rapide, pas de consommation de ressources quand arrêté. En ligne de commande, docker compose down arrête les services et docker compose up -d les relance.
Questions fréquentes
Transcription complète
Pour aller plus loin
Ce tutoriel vous a été utile ? Contactez-moi pour un accompagnement personnalisé sur n8n.