Installer n8n sur un VPS avec Docker

1. Préparer le VPS et se connecter

Prépare un VPS sous Ubuntu, un domaine dont tu peux modifier le DNS, une adresse e-mail et une clé SSH. Contabo et Hostinger sont deux exemples de fournisseurs. Vérifie le prix actuel, les ressources et les frais éventuels avant de choisir.

Depuis ton Terminal, remplace TON_UTILISATEUR et IP_DU_VPS par les informations de ton serveur. Utilise un compte autorisé à exécuter sudo.

• Tu as accès au serveur en SSH.
• Tu connais l’adresse IP publique du VPS.

ssh TON_UTILISATEUR@IP_DU_VPS

2. Relier le domaine au VPS

Dans le DNS de ton domaine, crée un enregistrement A nommé n8n qui pointe vers l’adresse IPv4 publique du VPS. Ton adresse sera par exemple n8n.exemple.com. Si un enregistrement AAAA existe, vérifie qu’il pointe aussi vers le bon serveur.

Garde ton accès SSH fonctionnel et autorise les ports 80 et 443 dans les pare-feu du VPS et du fournisseur pour le proxy et le HTTPS. Le port 5678 de n8n reste privé.

dig +short n8n.exemple.com A

3. Installer Docker et Compose

Suis la procédure officielle Docker pour Ubuntu indiquée dans les sources. Installe Docker Engine avec le plugin Docker Compose. Les commandes du guide utilisent sudo pour exécuter Docker.

sudo docker --version
sudo docker compose version

4. Configurer et démarrer n8n

Crée un dossier n8n-compose, puis un fichier .env à l’intérieur. Colle les variables ci-dessous et remplace le domaine et l’adresse e-mail par les tiens.

Dans le même dossier, crée compose.yaml en reprenant le fichier de la section « Create Docker Compose file » de la documentation officielle n8n en bas du guide. Ce fichier configure n8n, son stockage persistant et Traefik pour le HTTPS.

Crée aussi le dossier local-files comme indiqué dans la documentation. Lance ensuite sudo docker compose config -q pour vérifier la configuration, puis sudo docker compose up -d et sudo docker compose ps pour vérifier le démarrage.

• Les fichiers .env et compose.yaml sont dans le même dossier.
• Le domaine pointe vers le VPS et le proxy peut atteindre les ports 80 et 443.

DOMAIN_NAME=exemple.com
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Africa/Casablanca
SSL_EMAIL=admin@exemple.com

5. Tester ton premier workflow

Ouvre ton adresse HTTPS et crée ton compte propriétaire. Si la page ne s’ouvre pas, vérifie le DNS, les pare-feu et les journaux. Ne partage jamais tes identifiants ni tes clés.

Ajoute un Schedule Trigger et un nœud Edit Fields à un workflow. Configure un déclenchement court, publie le workflow, puis vérifie la section Executions après le déclenchement. Mets le workflow en pause à la fin du test.

sudo docker compose logs --tail=100 traefik n8n

6. Garder ton instance en ligne

Ton workflow peut tourner pendant que ton ordinateur est éteint, tant que le VPS et n8n restent disponibles. La capacité dépend des ressources du serveur et les services que tu connectes peuvent imposer leurs propres quotas.

Sauvegarde le volume de données n8n, la base de données si elle est externe, la configuration et la clé de chiffrement. Garde une copie protégée hors du VPS et teste la restauration avant de compter sur ces sauvegardes.

• HTTPS fonctionne.
• Le workflow planifié apparaît dans Executions.
• Tu sais où sont tes sauvegardes et comment les restaurer.