Héberger n8n soi-même sur une Zenbyte Cloud VPS
Ce guide explique comment héberger n8n sur une Cloud VPS. La configuration utilise :
-
Caddy comme reverse proxy afin de rendre n8n accessible de manière sécurisée depuis Internet
-
Docker Compose pour définir et exécuter l’ensemble des services nécessaires
Cette configuration s’adresse aux clients ayant souscrit une Cloud VPS et souhaitant installer et gérer n8n de façon autonome.
Compétences requises
L’auto-hébergement de n8n nécessite des connaissances techniques, notamment :
-
Administration de serveurs Linux
-
Docker et Docker Compose
-
Gestion des ressources et montée en charge
-
Sécurisation des serveurs et des applications web
-
Configuration et maintenance de n8n
Une configuration incorrecte peut entraîner des pertes de données, des failles de sécurité ou des interruptions de service. Utilisez cette configuration en production uniquement si vous disposez de l’expérience nécessaire.
Versions Stable et Beta
n8n publie régulièrement de nouvelles versions :
-
Version Stable – adaptée aux environnements de production
-
Version Beta – inclut les dernières fonctionnalités mais peut être instable
Pour les environnements en ligne, il est recommandé d’utiliser la version Stable. Les problèmes liés aux versions Beta peuvent être signalés via la communauté n8n.
Créer une Cloud VPS
-
Connectez-vous au panneau de contrôle de votre fournisseur VPS
-
Créez une nouvelle Cloud VPS ou sélectionnez un projet existant
-
Choisissez une distribution Linux compatible avec Docker (Ubuntu LTS est recommandé)
-
Si disponible, sélectionnez une image avec Docker préinstallé
Type de VPS
Pour la plupart des usages, une Cloud VPS d’entrée ou de milieu de gamme est suffisante. Des workflows n8n plus complexes nécessiteront davantage de CPU et de mémoire.
Authentification
Utilisez l’authentification par clé SSH plutôt que par mot de passe pour une meilleure sécurité.
Ce guide suppose un accès au serveur via SSH.
Connexion au serveur
Connectez-vous à votre VPS via SSH :
Installer Docker Compose
Si Docker Compose n’est pas encore installé :
Vérifiez l’installation :
Cloner le dépôt de configuration
Cette configuration utilise un dépôt Docker Compose prêt à l’emploi pour n8n et Caddy.
Clonez le dépôt :
Dossiers et fichiers par défaut
La configuration comprend deux dossiers importants montés dans les conteneurs Docker :
-
caddy_config – contient la configuration de Caddy
-
local_files – stocke les fichiers téléversés ou générés via n8n
Cela permet de conserver les données même après un redémarrage des conteneurs.
Créer les volumes Docker
Créer un volume pour Caddy (certificats SSL et cache) :
Créer un volume pour les données n8n :
Configurer le DNS
n8n fonctionne généralement sur un sous-domaine, par exemple :
Créez un enregistrement A chez votre fournisseur DNS pointant vers l’adresse IP de votre VPS.
Ouvrir les ports requis
Pour accéder à n8n, le serveur doit autoriser :
-
Port 80 (HTTP)
-
Port 443 (HTTPS)
Avec UFW :
Configurer n8n (.env)
n8n utilise des variables d’environnement définies dans le fichier .env.
Ouvrez le fichier :
Remplacez les valeurs d’exemple par votre propre configuration.
Les commentaires dans le fichier expliquent le rôle de chaque variable.
Pour la liste complète, consultez la documentation officielle des variables d’environnement n8n.
Configuration Docker Compose
Le fichier docker-compose.yml définit deux services :
-
Caddy
-
Écoute sur les ports 80 et 443
-
Gère automatiquement les certificats HTTPS
-
-
n8n
-
Exécute l’application n8n
-
Utilise les variables définies dans le fichier
.env -
Stocke les données dans des volumes persistants
-
Il n’est généralement pas nécessaire de modifier ce fichier, mais vous pouvez le consulter avec :
Configurer Caddy
Éditez le fichier de configuration Caddy :
Remplacez le sous-domaine d’exemple par le vôtre :
Caddy redirige ainsi le trafic externe vers le conteneur n8n.
Démarrer n8n et Caddy
Démarrez les conteneurs :
Le premier démarrage peut prendre quelques minutes, notamment pour l’émission des certificats SSL.
Tester l’installation
Ouvrez dans votre navigateur :
Connectez-vous avec les identifiants définis dans le fichier .env.
Si tout est correctement configuré, l’interface n8n s’affiche.
Arrêter les services
Pour arrêter n8n et Caddy :
Mettre à jour n8n
Pour mettre à jour n8n via Docker Compose :
Points importants
-
Toujours effectuer des sauvegardes avant les mises à jour
-
Surveiller l’utilisation du CPU et de la mémoire
-
Sécuriser correctement la VPS (pare-feu, mises à jour, sécurité SSH)
Avec cette configuration, n8n est entièrement géré de manière autonome sur votre Zenbyte Cloud VPS.