
N8N est une plateforme d’automatisation open-source qui vous permet de créer des workflows sans code. Contrairement aux solutions cloud comme Zapier ou Make, N8N peut être auto-hébergé sur votre propre machine. En installant N8N avec Docker Compose et PostgreSQL, vous obtenez une instance locale fonctionnelle en moins de 5 minutes, accessible hors connexion et totalement sous votre contrôle.
Pourquoi installer N8N avec Docker ?
Docker simplifie considérablement le déploiement de N8N. Plutôt que d’installer manuellement Node.js, PostgreSQL et de gérer les dépendances, Docker Compose orchestre tout automatiquement. Les avantages sont multiples :
- Installation rapide : moins de 5 minutes pour une instance fonctionnelle.
- Accès hors connexion : travaillez sur vos workflows même sans internet (seuls les nœuds nécessitant une API externe seront limités).
- Contrôle total : démarrez et arrêtez N8N à volonté sans impacter votre système.
- Persistance des données : PostgreSQL stocke vos workflows de manière fiable.
Prérequis : installer Docker Desktop
Avant d’installer N8N, vous devez disposer de Docker Desktop sur votre machine. L’application est disponible pour Windows, macOS et Linux.
Étapes d’installation Docker
- Accédez à la documentation officielle : rendez-vous sur docs.docker.com et sélectionnez votre système d’exploitation.
- Téléchargez l’installateur : cliquez sur « Docker Desktop for Windows » (ou Mac/Linux selon votre OS).
- Lancez l’installation : exécutez le fichier téléchargé et suivez les instructions.
- Redémarrez votre ordinateur : Docker Desktop nécessite un redémarrage pour finaliser l’installation.
- Vérifiez l’installation : lancez Docker Desktop. L’interface doit s’afficher sans erreur.
Télécharger les fichiers N8N Docker Compose
N8N met à disposition un dépôt GitHub contenant tous les fichiers nécessaires au déploiement avec Docker Compose.
Étape 1 : Accéder au dépôt GitHub
Rendez-vous sur la documentation officielle N8N. Un lien vert vous redirige vers le dépôt GitHub n8n-io/n8n-hosting.
Étape 2 : Télécharger les fichiers
Sur le dépôt GitHub, cliquez sur le bouton Code puis Download ZIP. Extrayez l’archive dans un dossier de votre choix.
Étape 3 : Naviguer vers le bon dossier
Dans le dossier extrait, naviguez vers : docker-compose → withPostgres. Vous y trouverez quatre fichiers essentiels :
- .env : contient les identifiants et mots de passe (modifiez-les en production).
- docker-compose.yml : définit les services N8N et PostgreSQL.
Lancer N8N avec Docker Compose
Étape 1 : Ouvrir le terminal
Sous Windows, recherchez « Invite de commandes » dans le menu Démarrer et ouvrez l’application. Sous macOS ou Linux, ouvrez le Terminal.
Étape 2 : Se positionner dans le dossier
Utilisez la commande cd suivie du chemin vers le dossier withPostgres. Pour vérifier que vous êtes au bon endroit, tapez dir (Windows) ou ls (Mac/Linux). Vous devez voir les fichiers .env et docker-compose.yml.
Étape 3 : Exécuter Docker Compose
Lancez la commande suivante :
docker compose up -d
Docker va télécharger les images nécessaires (N8N et PostgreSQL) puis démarrer les conteneurs. La première exécution peut prendre quelques minutes selon votre connexion internet.
Accéder à l’interface N8N
Une fois les conteneurs démarrés, ouvrez Docker Desktop. Dans l’onglet Containers, vous verrez deux conteneurs avec des pastilles vertes : PostgreSQL et N8N.
N8N est accessible à l’adresse : http://localhost:5678
Au premier accès, N8N vous demande de créer un compte. Renseignez vos informations personnelles (email, mot de passe). Vous pouvez également demander une licence d’essai gratuite de 14 jours pour accéder à toutes les fonctionnalités.
Gérer les conteneurs Docker
L’un des avantages de Docker Desktop est la gestion simplifiée de vos conteneurs. Vous n’êtes pas obligé de laisser N8N tourner en permanence sur votre machine.
Arrêter N8N
Dans Docker Desktop, sélectionnez le projet contenant les conteneurs N8N et PostgreSQL, puis cliquez sur Stop. L’URL http://localhost:5678 ne sera plus accessible.
Relancer N8N
Pour relancer N8N ultérieurement, ouvrez Docker Desktop, sélectionnez les conteneurs et cliquez sur Play. En 10 à 15 secondes, votre instance N8N sera à nouveau accessible avec tous vos workflows intacts.

Quelle commande permet de lancer N8N avec Docker Compose ?
Conseils pour la production
L’installation locale avec Docker Compose est idéale pour le développement et les tests. Pour un déploiement en production, quelques ajustements sont nécessaires :
- Modifiez les identifiants : changez les valeurs par défaut dans le fichier
.env(mot de passe PostgreSQL, clé de chiffrement N8N). - Configurez un reverse proxy : utilisez Nginx ou Caddy pour exposer N8N avec HTTPS.
- Sauvegardez régulièrement : exportez vos workflows et sauvegardez le volume PostgreSQL.
Conclusion
Installer N8N avec Docker Compose est la méthode la plus rapide pour obtenir une instance fonctionnelle sur votre machine. En moins de 5 minutes, vous disposez d’un environnement complet avec PostgreSQL pour stocker vos workflows. L’installation fonctionne sur Windows, macOS et Linux, et vous pouvez démarrer ou arrêter N8N à volonté depuis Docker Desktop.
Pour aller plus loin, explorez nos autres ressources N8N ou contactez notre équipe pour un accompagnement sur vos projets d’automatisation.
Installez Docker Desktop, téléchargez le dépôt GitHub n8n-hosting, naviguez vers le dossier docker-compose/withPostgres, puis exécutez la commande ‘docker compose up -d’. N8N sera accessible sur http://localhost:5678.
L’installation complète prend moins de 5 minutes une fois Docker Desktop installé. La première exécution de ‘docker compose up -d’ télécharge les images Docker, ce qui peut prendre quelques minutes selon votre connexion internet.
Oui, une fois installé localement avec Docker, N8N fonctionne hors connexion. Vous pouvez créer et modifier vos workflows sans internet. Seuls les nœuds qui appellent des APIs externes (Gmail, Slack, etc.) nécessiteront une connexion.
Dans Docker Desktop, allez dans l’onglet Containers, sélectionnez le projet N8N et cliquez sur Stop pour l’arrêter. Pour relancer, sélectionnez les conteneurs et cliquez sur Play. Le redémarrage prend environ 10-15 secondes.
Pour un usage local de test, vous pouvez conserver les valeurs par défaut. En revanche, pour un déploiement en production, modifiez impérativement les identifiants PostgreSQL et la clé de chiffrement N8N pour des raisons de sécurité.
Oui, la procédure est identique sur Windows, macOS et Linux. Seule l’installation de Docker Desktop diffère légèrement selon le système d’exploitation. Les commandes Docker Compose restent les mêmes.
