Développement web

Installer n8n sur un VPS OVH avec Docker, pas à pas

Installer n8n sur un VPS OVH avec Docker, pas à pas

    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 ?

    • 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 :

    TypeNomDestination
    An8nadresse 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

    Continuez votre lecture

    Sur le même thème

    Hébergement WordPress infogéré ou mutualisé : ce que « infogéré » couvre vraiment
    Développement web

    Hébergement WordPress infogéré ou mutualisé : ce que « infogéré » couvre vraiment

    Un hébergement WordPress infogéré ne couvre pas toujours les mises à jour, les tests, les sauvegardes et la…

    Exploration approfondie du Prompt Engineering
    Développement web

    Prompt engineering : définition, techniques et exemples concrets

    Le prompt engineering, c'est l'art de donner des instructions claires à ChatGPT, Claude ou Gemini pour obtenir des…

    turboquant-5
    Développement web

    Avec TurboQuant Google vient de rendre l’IA 8 fois plus rapide. Voici ce que ca change