La procédure complète pour installer n8n avec Docker Compose sur un VPS OVH, du sous-domaine au certificat HTTPS. Avec la routine de sauvegarde et de mise à jour à mettre en place dès le premier jour.
Pour installer n8n avec Docker sur un VPS OVH, il faut quatre choses : un VPS sous Debian ou Ubuntu, un sous-domaine qui pointe vers son adresse IP, Docker avec son extension Compose, et un fichier compose.yaml qui lance n8n derrière un proxy (Traefik) chargé du certificat HTTPS. Comptez une heure si vous êtes à l’aise avec un terminal. Le plus important vient après : sauvegarder le volume de données et la clé de chiffrement, et mettre n8n à jour régulièrement.
Ce tutoriel suit la procédure officielle de n8n (Docker Compose + Traefik), avec les commandes exactes, les deux ou trois ajustements que l’on recommande pour un serveur en production, et une routine de sauvegarde. Il s’adresse à quelqu’un qui sait se connecter en SSH ; si le vocabulaire serveur vous est étranger, lisez d’abord notre article sur le serveur web.
Sommaire
- De quoi avez-vous besoin avant de commencer ?
- Étape 1 : faire pointer un sous-domaine vers le VPS
- Étape 2 : préparer et sécuriser le serveur
- Étape 3 : installer Docker et Docker Compose
- Étape 4 : créer le dossier du projet et le fichier .env
- Étape 5 : écrire le fichier compose.yaml
- Étape 6 : lancer n8n et créer le compte propriétaire
- Étape 7 : mettre en place les sauvegardes
- Étape 8 : mettre n8n à jour
- Les erreurs fréquentes et comment les corriger
- Faut-il vraiment l’héberger soi-même ?
- Questions fréquentes
- Sources
De quoi avez-vous besoin avant de commencer ?
- Un VPS : n8n tourne confortablement sur une petite machine pour un usage de TPE ou PME. Chez OVHcloud, le VPS-1 (2 vCores, 4 Go de RAM, 40 Go de SSD NVMe) est affiché à partir de 4,57 € TTC par mois en septembre 2026. Choisissez de préférence une image Debian 13 ou Debian 12 : ce sont les deux versions de Debian prises en charge par Docker.
- Un nom de domaine dont vous gérez la zone DNS, pour créer un sous-domaine du type n8n.votre-domaine.fr.
- Un accès SSH au VPS, idéalement par clé plutôt que par mot de passe.
- Une adresse e-mail pour l’émission du certificat HTTPS Let’s Encrypt.
Avant de vous lancer : la documentation de n8n rappelle que l’auto-hébergement est recommandé aux utilisateurs expérimentés, car une erreur de configuration peut entraîner perte de données, faille de sécurité ou interruption de service. Si personne dans l’équipe ne peut s’occuper du serveur dans la durée, la version cloud de n8n est plus raisonnable.
Étape 1 : faire pointer un sous-domaine vers le VPS
Dans l’interface de votre registrar (l’espace client OVHcloud si votre domaine y est), ajoutez un enregistrement DNS de type A :
| Type | Nom | Destination |
|---|---|---|
| A | n8n | adresse IPv4 de votre VPS |
La propagation prend de quelques minutes à quelques heures selon la durée de vie (TTL) de la zone ; notre article sur le TTL DNS explique pourquoi. Vérifiez depuis votre poste :
dig +short n8n.votre-domaine.fr
La commande doit renvoyer l’adresse IP du VPS. Tant que ce n’est pas le cas, inutile d’aller plus loin : Traefik ne pourra pas obtenir le certificat.
Étape 2 : préparer et sécuriser le serveur
Connectez-vous en SSH avec l’utilisateur indiqué dans l’e-mail de livraison du VPS, puis mettez le système à jour :
sudo apt update && sudo apt upgrade -y
Trois réflexes de base avant d’exposer un service sur Internet :
- désactiver la connexion SSH par mot de passe une fois votre clé installée (directive PasswordAuthentication no dans /etc/ssh/sshd_config) ;
- n’ouvrir que les ports 22 (SSH), 80 et 443 (web) ;
- installer les mises à jour de sécurité automatiquement (paquet unattended-upgrades sur Debian).
Attention au pare-feu : la documentation de Docker précise que le trafic vers les ports publiés par un conteneur est dévié avant de passer par les règles de ufw. Autrement dit, un port publié par Docker peut rester accessible même si ufw le bloque. C’est pour cette raison que, dans le fichier compose ci-dessous, le port de n8n est publié uniquement sur 127.0.0.1 : seul Traefik est exposé sur 80 et 443.
Étape 3 : installer Docker et Docker Compose
On utilise le dépôt officiel de Docker, comme le recommande sa documentation pour Debian. Ajoutez d’abord la clé et le dépôt :
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
Puis installez Docker Engine et le plugin Compose, et vérifiez :
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version
sudo docker run hello-world
Si vous ne voulez pas taper sudo devant chaque commande Docker, ajoutez votre utilisateur au groupe docker (sudo usermod -aG docker $USER), puis reconnectez-vous. Sachez que l’appartenance à ce groupe donne des droits équivalents à root sur la machine.
Étape 4 : créer le dossier du projet et le fichier .env
Créez un dossier dédié. Son nom compte : Docker Compose s’en sert pour nommer les volumes (ici n8n-compose_n8n_data), ce qui servira pour les sauvegardes.
mkdir ~/n8n-compose
cd ~/n8n-compose
mkdir local-files
Le dossier local-files est partagé entre le serveur et n8n (monté sur /files dans le conteneur). On s’en servira aussi pour les exports de sauvegarde. Créez ensuite le fichier .env :
nano .env
Avec ce contenu, adapté à votre domaine :
DOMAIN_NAME=votre-domaine.fr
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Europe/Paris
SSL_EMAIL=vous@votre-domaine.fr
Le fuseau horaire n’est pas un détail : c’est lui qu’utilisent les nœuds de planification. Sans lui, n8n se cale sur New York par défaut, et votre rapport « tous les lundis à 8 h » partirait à 14 h.
Étape 5 : écrire le fichier compose.yaml
Créez compose.yaml dans le même dossier. Le contenu ci-dessous reprend la configuration officielle de n8n. Seul changement : on a retiré l’option –api.insecure=true de Traefik, qui active son tableau de bord et n’est pas utile ici.
services:
traefik:
image: "traefik"
restart: always
command:
- "--providers.docker=true"
- "--providers.docker.exposedbydefault=false"
- "--entrypoints.web.address=:80"
- "--entrypoints.web.http.redirections.entryPoint.to=websecure"
- "--entrypoints.web.http.redirections.entrypoint.scheme=https"
- "--entrypoints.websecure.address=:443"
- "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
- "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
- "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
ports:
- "80:80"
- "443:443"
volumes:
- traefik_data:/letsencrypt
- /var/run/docker.sock:/var/run/docker.sock:ro
n8n:
image: n8nio/n8n
restart: always
ports:
- "127.0.0.1:5678:5678"
labels:
- traefik.enable=true
- traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
- traefik.http.routers.n8n.tls=true
- traefik.http.routers.n8n.entrypoints=web,websecure
- traefik.http.routers.n8n.tls.certresolver=mytlschallenge
- traefik.http.middlewares.n8n.headers.SSLRedirect=true
- traefik.http.middlewares.n8n.headers.STSSeconds=315360000
- traefik.http.middlewares.n8n.headers.browserXSSFilter=true
- traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
- traefik.http.middlewares.n8n.headers.forceSTSHeader=true
- traefik.http.middlewares.n8n.headers.SSLHost=${DOMAIN_NAME}
- traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
- traefik.http.middlewares.n8n.headers.STSPreload=true
- traefik.http.routers.n8n.middlewares=n8n@docker
environment:
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- NODE_ENV=production
- WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
- N8N_RESTRICT_FILE_ACCESS_TO=/files
volumes:
- n8n_data:/home/node/.n8n
- ./local-files:/files
volumes:
n8n_data:
traefik_data:
Ce que fait ce fichier, en clair :
- Traefik écoute sur les ports 80 et 443, redirige tout le HTTP vers HTTPS et obtient automatiquement un certificat Let’s Encrypt pour votre sous-domaine. Si le chiffrement vous paraît secondaire, notre article sur le HTTPS rappelle pourquoi il ne l’est pas, a fortiori pour un outil qui stocke vos accès à d’autres services.
- n8n n’est joignable qu’en local sur le port 5678 ; c’est Traefik qui lui transmet les requêtes.
- WEBHOOK_URL indique à n8n son adresse publique : sans elle, les URL de webhook affichées dans l’éditeur seraient fausses.
- Le volume n8n_data contient la base SQLite, la configuration et la clé de chiffrement des identifiants. C’est lui qu’il faut sauvegarder.
Étape 6 : lancer n8n et créer le compte propriétaire
sudo docker compose up -d
sudo docker compose logs -f n8n
Quittez les logs avec Ctrl+C quand n8n indique qu’il est prêt. Ouvrez ensuite https://n8n.votre-domaine.fr dans votre navigateur.
Créez immédiatement le compte propriétaire. Le premier visiteur qui remplit cet écran devient propriétaire de l’instance : ne laissez pas une installation fraîche exposée sans l’avoir fait. Activez ensuite la double authentification dans les paramètres de votre compte.
Pour vérifier que le certificat et la redirection fonctionnent :
curl -I http://n8n.votre-domaine.fr
curl -I https://n8n.votre-domaine.fr
La première commande doit renvoyer une redirection vers HTTPS, la seconde une réponse du serveur sans erreur de certificat.
Étape 7 : mettre en place les sauvegardes
La documentation de n8n distingue deux niveaux de sauvegarde, et il faut les deux.
La sauvegarde complète du volume
Avec la base SQLite par défaut, tout tient dans le dossier .n8n, donc dans le volume n8n_data : base de données (utilisateurs, workflows, historique), fichier config contenant la clé de chiffrement. n8n recommande d’arrêter l’application avant de copier ce dossier, pour éviter une copie incohérente de la base :
cd ~/n8n-compose
sudo docker compose stop n8n
sudo docker run --rm \
-v n8n-compose_n8n_data:/data:ro \
-v "$PWD/backups":/backup \
alpine tar czf /backup/n8n_data-$(date +%F).tar.gz -C /data .
sudo docker compose start n8n
L’interruption dure quelques secondes. Programmez ce script la nuit avec cron, et surtout copiez l’archive hors du VPS (espace de stockage objet, autre serveur, NAS) : une sauvegarde qui reste sur la machine qu’elle protège ne protège de rien.
L’export lisible des workflows et identifiants
En complément, exportez workflows et identifiants en fichiers JSON avec la ligne de commande de n8n. Comme seul le dossier .n8n et local-files sont persistants, on écrit dans /files :
sudo docker compose exec n8n n8n export:workflow --backup --output=/files/backups/workflows/
sudo docker compose exec n8n n8n export:credentials --backup --output=/files/backups/credentials/
Ces exports ne contiennent ni les utilisateurs, ni l’historique d’exécution, ni les variables, ni la clé de chiffrement : ils servent à déplacer des workflows, pas à restaurer une instance entière. Les identifiants y restent chiffrés avec la clé de l’instance.
La clé de chiffrement est vitale. n8n enregistre vos identifiants (accès API, mots de passe SMTP, jetons OAuth) sous forme chiffrée. Sans le fichier config du volume, ou la variable N8N_ENCRYPTION_KEY si vous en avez défini une, une base restaurée ne peut plus les déchiffrer. Rangez une copie de cette clé dans votre gestionnaire de mots de passe.
Étape 8 : mettre n8n à jour
n8n publie une nouvelle version mineure presque chaque semaine et conseille de mettre à jour au moins une fois par mois, en lisant les notes de version pour repérer les changements incompatibles. Faites une sauvegarde complète juste avant, puis :
cd ~/n8n-compose
sudo docker compose pull
sudo docker compose down
sudo docker compose up -d
L’image n8nio/n8n sans étiquette suit la version stable. Si vous préférez maîtriser le rythme des mises à jour, fixez une version précise dans compose.yaml (par exemple image: n8nio/n8n:2.40.7, la version stable indiquée par la documentation au moment où l’on écrit) et changez-la volontairement.
Pensez aussi à la surveillance : un workflow qui ne tourne plus ne prévient personne. Un outil de monitoring de site web qui vérifie l’URL de votre instance toutes les quelques minutes suffit à être alerté d’une panne.
Les erreurs fréquentes et comment les corriger
- Le certificat ne s’obtient pas : le sous-domaine ne pointe pas encore vers le VPS, ou le port 80 ou 443 est fermé par un pare-feu (celui du système ou le pare-feu réseau proposé par OVHcloud, s’il est activé). Consultez les logs avec sudo docker compose logs traefik.
- Les webhooks affichent localhost:5678 : la variable WEBHOOK_URL est absente ou mal écrite.
- Les planifications partent à la mauvaise heure : GENERIC_TIMEZONE n’est pas défini.
- Les identifiants sont illisibles après une restauration : la clé de chiffrement d’origine n’a pas été restaurée.
- Le serveur sature : l’historique d’exécution grossit avec le temps. Surveillez l’espace disque (df -h) et réglez la purge des exécutions dans les variables d’environnement de n8n.
Faut-il vraiment l’héberger soi-même ?
L’auto-hébergement se justifie quand le volume rend le cloud coûteux, ou quand vos données doivent rester sur une infrastructure que vous contrôlez. Son coût caché : mises à jour, sauvegardes testées, surveillance.
Si vous voulez déléguer l’installation, l’hébergement ou la conception des workflows eux-mêmes, on peut prendre le relais dans le cadre de nos prestations d’automatisation et d’intégration : une intégration API simple démarre à 1 500 € et une automatisation multi-outils à 3 000 €. Écrivez-nous à contact@osmova.com ou passez par notre formulaire de contact.
Questions fréquentes
Quelle taille de VPS choisir pour n8n ?
Pour quelques dizaines de workflows et un volume modéré, une petite machine suffit : le VPS-1 d’OVHcloud (2 vCores, 4 Go de RAM) laisse de la marge. Si vous traitez de gros fichiers ou beaucoup d’exécutions simultanées, montez en gamme ou passez à une base PostgreSQL.
SQLite ou PostgreSQL ?
SQLite, choisi par défaut, convient à une instance unique et simplifie la sauvegarde. PostgreSQL devient pertinent pour un gros volume ou le mode file d’attente de n8n ; il faut alors sauvegarder la base avec ses propres outils, en plus du dossier .n8n.
Peut-on installer n8n sur un hébergement mutualisé ?
Non en pratique : n8n est une application Node.js qui doit tourner en permanence, ce que les hébergements mutualisés classiques ne permettent pas. Il faut un VPS, un serveur dédié ou la version cloud.
L’édition Community est-elle gratuite pour une entreprise ?
Oui pour un usage interne : la licence de n8n (Sustainable Use License) autorise l’utilisation pour les besoins internes de l’entreprise. Elle interdit en revanche de revendre n8n comme service à des tiers.
Sources
- Documentation n8n, installation avec Docker Compose : https://docs.n8n.io/deploy/host-n8n/install-options/use-a-cloud-provider/use-docker-compose
- Documentation n8n, sauvegarde et restauration : https://docs.n8n.io/deploy/host-n8n/keep-n8n-running/backup-and-restore
- Documentation n8n, mettre à jour n8n : https://docs.n8n.io/deploy/host-n8n/keep-n8n-running/update-n8n
- Documentation n8n, installation avec Docker (mise à jour Compose) : https://docs.n8n.io/deploy/host-n8n/install-options/install-with-docker
- Licence de n8n : https://github.com/n8n-io/n8n/blob/master/LICENSE.md
- Documentation Docker, installation sur Debian : https://docs.docker.com/engine/install/debian/
- Documentation Docker, pare-feu et ports publiés : https://docs.docker.com/engine/network/packet-filtering-firewalls/
- OVHcloud, offres VPS : https://www.ovhcloud.com/fr/vps/




