Base de connaissances

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

  1. Connectez-vous au panneau de contrôle de votre fournisseur VPS

  2. Créez une nouvelle Cloud VPS ou sélectionnez un projet existant

  3. Choisissez une distribution Linux compatible avec Docker (Ubuntu LTS est recommandé)

  4. 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 :

 
ssh root@<ip-du-serveur>

Installer Docker Compose

Si Docker Compose n’est pas encore installé :

 
apt update && apt -y upgrade apt install docker-compose-plugin

Vérifiez l’installation :

 
docker compose version

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 :

 
git clone https://github.com/n8n-io/n8n-docker-caddy.git cd n8n-docker-caddy

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

 
docker volume create caddy_data

Créer un volume pour les données n8n :

 
docker volume create n8n_data

Configurer le DNS

n8n fonctionne généralement sur un sous-domaine, par exemple :

 
n8n.votredomaine.fr

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 :

 
ufw allow 80 ufw allow 443

Configurer n8n (.env)

n8n utilise des variables d’environnement définies dans le fichier .env.

Ouvrez le fichier :

 
nano .env

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 :

 
nano docker-compose.yml

Configurer Caddy

Éditez le fichier de configuration Caddy :

 
nano caddy_config/Caddyfile

Remplacez le sous-domaine d’exemple par le vôtre :

 
n8n.votredomaine.fr { reverse_proxy n8n:5678 { flush_interval -1 } }

Caddy redirige ainsi le trafic externe vers le conteneur n8n.


Démarrer n8n et Caddy

Démarrez les conteneurs :

 
docker compose up -d

Le premier démarrage peut prendre quelques minutes, notamment pour l’émission des certificats SSL.


Tester l’installation

Ouvrez dans votre navigateur :

 
https://n8n.votredomaine.fr

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 :

 
docker compose stop

Mettre à jour n8n

Pour mettre à jour n8n via Docker Compose :

 
# Se placer dans le répertoire contenant docker-compose.yml cd /chemin/vers/n8n-docker-caddy # Télécharger les images les plus récentes docker compose pull # Arrêter et supprimer les anciens conteneurs docker compose down # Démarrer la version mise à jour docker compose up -d

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.

  • n8n, Cloud VPS

Cette réponse était-elle pertinente?

0 Utilisateurs l'ont trouvée utile

Articles connexes

Aucun article trouvé