Installer n8n sur un VPS : le guide pas à pas

Avant de commencer

Il vous faut :

• un VPS sous Ubuntu ou Debian, avec 2 Go de mémoire au minimum. Voir notre sélection Meilleur VPS : quel hébergeur choisir en 2026 ? ;
• un nom de domaine dont vous gérez le DNS, pour une adresse comme n8n.mondomaine.fr ;
• un accès SSH au serveur.

Et, avant tout, sécurisez le serveur : clés SSH, pare-feu, mises à jour automatiques. Notre check-list Sécuriser un VPS : la check-list de départ prend une demi-heure et évite bien des ennuis.

Chemin 1 : le modèle en un clic

Certains hébergeurs proposent n8n comme modèle d'installation. Chez Hostinger, par exemple, il suffit de choisir le modèle n8n au moment de créer le VPS (ou de réinstaller son système) : Ubuntu, Docker et n8n sont installés et configurés automatiquement, avec HTTPS. Une variante installe n8n en mode file d'attente pour les usages intensifs.

Avantages : n8n est en ligne en quelques minutes, sans taper une commande.

Limites : vous dépendez de la configuration choisie par l'hébergeur, et il faudra quand même apprendre à mettre à jour et à sauvegarder. Lisez quand même la suite de ce guide pour comprendre ce qui tourne sur votre machine.

Chemin 2 : Docker Compose, pas à pas

C'est la méthode recommandée par la documentation officielle de n8n. Elle fonctionne chez n'importe quel hébergeur.

Étape 1 : faire pointer le domaine

Dans la zone DNS de votre domaine, créez un enregistrement de type A : n8n → l'adresse IP de votre VPS. La propagation prend de quelques minutes à quelques heures.

Étape 2 : installer Docker

Connectez-vous en SSH, puis installez Docker avec le script officiel :

curl -fsSL https://get.docker.com | sh

Vérifiez l'installation avec docker compose version.

Étape 3 : préparer les fichiers

Créez un dossier pour n8n et placez-y un fichier .env :

mkdir -p ~/n8n && cd ~/n8n

Contenu du fichier .env :

DOMAIN=n8n.mondomaine.fr
GENERIC_TIMEZONE=Europe/Paris

Étape 4 : le fichier docker-compose.yml

Ce fichier lance deux services : Caddy, qui obtient automatiquement le certificat HTTPS, et n8n.

services:
  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    command: caddy reverse-proxy --from ${DOMAIN} --to n8n:5678
    volumes:
      - caddy_data:/data

  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    environment:
      - N8N_HOST=${DOMAIN}
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://${DOMAIN}/
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  caddy_data:
  n8n_data:

Étape 5 : lancer n8n

docker compose up -d

Ouvrez https://n8n.mondomaine.fr : n8n vous demande de créer le compte propriétaire. Choisissez un mot de passe fort, enregistré dans votre Gestionnaire de mots de passe : pourquoi en utiliser un ?.

Les réglages qui comptent

• WEBHOOK_URL : indispensable pour que les webhooks affichent la bonne adresse publique. Sans lui, les services externes ne pourront pas déclencher vos workflows.
• Le fuseau horaire : sans GENERIC_TIMEZONE, vos déclencheurs planifiés tournent à l'heure UTC.
• La clé de chiffrement : n8n chiffre vos identifiants (clés d'API, mots de passe) avec une clé stockée dans son dossier de données. Perdez-la, et tous vos identifiants enregistrés deviennent inutilisables. Elle est dans le volume n8n_data.

Sauvegarder

Sauvegardez régulièrement le volume n8n_data : il contient la base SQLite, vos workflows, vos identifiants chiffrés et la clé de chiffrement. Exportez aussi vos workflows en JSON de temps en temps (menu de chaque workflow, ou via la ligne de commande de n8n). Envoyez ces sauvegardes hors du serveur.

Mettre à jour

cd ~/n8n
docker compose pull
docker compose up -d

Faites une sauvegarde avant, et lisez les notes de version pour les mises à jour majeures.

Les erreurs fréquentes

• Le certificat HTTPS ne s'obtient pas : le DNS ne pointe pas encore vers le serveur, ou les ports 80 et 443 sont fermés dans le pare-feu.
• Les webhooks affichent localhost : la variable WEBHOOK_URL manque.
• Les workflows planifiés se déclenchent à la mauvaise heure : fuseau horaire non défini.
• « Mismatching encryption keys » : le dossier de données a été recréé sans la clé d'origine. D'où l'importance de sauvegarder le volume entier.

Votre n8n est en ligne ? Passez à la pratique avec nos 7 automatisations utiles à mettre en place.