Installer Cloudron sur un VPS Ubuntu
Installez Cloudron sur un VPS Ubuntu vierge : DNS wildcard, script d’installation, premier démarrage, dimensionnement de 2 à 10 apps, mail, certificats et sauvegardes.
Installer Cloudron sur un VPS : la version courte
Pour installer Cloudron sur un VPS, vous avez besoin d’un serveur Ubuntu vierge, d’au moins 2 GB de RAM et d’un domaine dont vous pouvez modifier les enregistrements DNS. L’installation elle-même se résume à trois commandes et à un redémarrage. Presque tous les problèmes surviennent avant cette étape (mauvaise image de base, mauvais type de virtualisation) ou après (DNS, messagerie, sauvegardes).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron installe, met à jour et sauvegarde les applications auto-hébergées. Il délivre également leurs certificats TLS (transport layer security). Chaque application s’exécute dans Docker, nginx est placé devant l’ensemble des applications et chaque application reçoit son propre sous-domaine de votre domaine. C’est pour cette dernière raison que la configuration DNS doit être effectuée en premier.
Pourquoi Cloudron est exigeant sur le système d’exploitation de base
Le script d’installation vérifie le serveur avant d’installer quoi que ce soit. Si une vérification échoue, vous devez commander un nouveau serveur. Lisez ces conditions avant de choisir une image. Les vérifications de l’installateur citées dans cette section datent du 13 octobre 2026. La documentation d’installation actuelle demande un serveur Ubuntu 26.04 fraîchement installé.
- Ubuntu uniquement, et seulement trois versions. Toute autre version quitte avec
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 est refusé, et la documentation d’installation demande désormais un serveur Ubuntu 26.04 fraîchement installé. Debian, Rocky et Alpine ne sont pas pris en charge. Ubuntu 24.04 nécessite Cloudron 8 ou une version plus récente, et le script le vérifie pour vous. - Architecture Intel ou AMD 64 bits uniquement :
Error: Cloudron only supports amd64/x86_64. Un VPS ARM ne peut pas l’exécuter. - Virtualisation matérielle complète uniquement. Sur un VPS basé sur des conteneurs, le script s’arrête avec
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization, car il détecte le conteneur avecsystemd-detect-virt --container. KVM convient. OpenVZ et LXC ne sont pas pris en charge. - Le système de fichiers racine doit être
ext4ouxfs. Avec tout autre système de fichiers, vous obtenezError: Cloudron requires '/' to be ext4 or xfs. C’est ainsi que les images btrfs et zfs échouent. - Au moins 941 MB de RAM, mesurés avec
free -m, et 18 GB sur/, mesurés d’après la taille du système de fichiers racine. Le message d’erreur demande 20GB, mais la vérification elle-même accepte un système de fichiers racine de 19 GB. - Un serveur réellement vierge. Si
nginx,dockerounodeest déjà installé, le script refuse de continuer avecError: Some packages like nginx/docker/nodejs are already installed.
C’est cette dernière vérification qui suscite le plus de discussions. Voici pourquoi elle existe. Cloudron installe des versions figées de Docker, nginx, Node.js et MySQL, écrit la configuration nginx de chaque application qu’il héberge et gère lui-même les règles du pare-feu iptables. Un Docker installé la veille aurait une version incorrecte. Le script quitte donc sans rien modifier et vous demande de commencer avec une installation Ubuntu vierge. Cloudron contrôle toute la machine. Attribuez-lui donc un VPS dédié.
Une autre vérification est facile à manquer. Sur un processeur ancien sans AVX (advanced vector extensions), le script affiche CPU has no AVX support. MongoDB will be disabled, et toutes les applications qui nécessitent MongoDB deviennent impossibles à installer. Vérifiez le processeur avant de vous engager avec grep -m1 -o avx /proc/cpuinfo. Cette commande affiche avx sur un hôte compatible et ne renvoie rien sur un hôte ancien.
De combien de RAM Cloudron a-t-il besoin ?
Le contrôle de l’installateur du 13 octobre 2026 refusait de s’exécuter avec moins de 941 MB, avec Error: Cloudron requires atleast 1GB physical memory ; la documentation actuelle demande 2 GB de RAM et 20 GB de disque. Ces deux valeurs constituent le minimum requis par la plateforme, sans les applications que vous installez. Cloudron exécute Docker, nginx, son propre service box et la stack de messagerie. Il provisionne aussi des services de base de données partagés lorsque vous déployez des applications. Exécutez docker ps sur une installation neuve et comptez-les.
Les limites mémoire des applications s’ajoutent à cette base. Chaque package d’application est livré avec une limite par défaut faible. Vous pouvez l’augmenter avec le curseur de la vue Resources de l’application. Lorsqu’une application dépasse sa limite, elle redémarre et vous envoie une notification OOM (out of memory). Un serveur qui redémarre sans cesse une application a donc généralement un problème de limite, et non un bug.
Voici le dimensionnement que je recommande. Il s’agit de recommandations pour un serveur que vous ne devrez pas reconstruire le mois prochain. Ce ne sont pas des résultats de benchmark mesurés.
Les données de ce graphique
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Deux applications fonctionnent confortablement avec 4 GB de RAM et 60 GB de disque. Une dizaine d’applications nécessitent environ 16 GB de RAM et 240 GB de disque, car la base de la plateforme ne diminue jamais et chaque application ajoute une image Docker, une base de données et ses propres données. Le disque se remplit plus vite que prévu : les images, les données des applications et les sauvegardes locales utilisent le même volume tant que vous ne déplacez pas les sauvegardes ailleurs.
Cloudron fournit à chaque application un swap illimité. La limite mémoire que vous définissez s’applique donc uniquement à la RAM. Sur une image VPS sans fichier swap, swapon --show n’affiche absolument rien. La pression mémoire provoque alors directement des redémarrages OOM au lieu de ralentir l’application. Ajouter 2 GB de swap constitue une précaution peu coûteuse, mais cela ne remplace pas la mémoire réelle. L’écart entre les offres VPS est faible par rapport aux heures que vous passerez à ajuster les limites. Consultez donc le coût réel d’un VPS et choisissez la taille supérieure.
DNS : l’enregistrement wildcard qui permet aux sous-domaines des applications de fonctionner
Cloudron place le dashboard sur my.example.com et chaque application sur son propre sous-domaine. Le DNS est donc un prérequis, pas une étape ultérieure. Pointez ces enregistrements vers l’adresse IP publique du serveur avant d’ouvrir le dashboard pour la première fois :
my.example.comcomme enregistrement A. Il s’agit du dashboard.*.example.comcomme enregistrement A. C’est lui qui permet aux sous-domaines des applications de fonctionner. Ainsi,wiki.example.cometgit.example.comseront résolus dès que vous installerez ces applications.example.comcomme enregistrement A, uniquement si vous voulez héberger une application sur le domaine nu.
Un enregistrement wildcard a une priorité inférieure à celle d’un enregistrement explicite. Un enregistrement www.example.com existant qui pointe vers une autre destination continue donc de fonctionner.
Pendant la configuration, vous choisissez la façon dont Cloudron gère ensuite le DNS :
- Un fournisseur avec API. Cloudron stocke un token pour Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS et d’autres fournisseurs (22 intégrations DNS avec API au total, hors Wildcard, Manual et No-op), puis crée lui-même chaque enregistrement, y compris les enregistrements de messagerie.
- Wildcard. Vous ajoutez manuellement l’enregistrement
*et Cloudron n’écrit rien. - Manual. Cloudron vous affiche chaque enregistrement et attend que vous l’ajoutiez avant chaque installation d’application.
Un enregistrement DNS wildcard n’est pas un certificat wildcard. Le fournisseur de certificats par défaut est Let's Encrypt Prod - Wildcard. Il vérifie la propriété du domaine via le DNS et ne fonctionne donc qu’avec un fournisseur disposant d’une API. Avec les backends Wildcard ou Manual, Let's Encrypt émet des certificats individuels validés via HTTP. Le port entrant 80 doit alors être accessible pour l’émission et le renouvellement. Vous pouvez aussi désactiver l’intégration Let's Encrypt et importer un certificat wildcard personnalisé. Le port 80 n’est alors pas requis en permanence pour la validation du certificat. Si votre registrar ou votre hébergeur DNS figure dans la liste des fournisseurs avec API, utilisez-le : la gestion des enregistrements de messagerie et des certificats ne sera plus à votre charge.
Vérifiez ces éléments avant de continuer. dig +short my.example.com et dig +short anything.example.com doivent tous deux afficher l’adresse IP de votre serveur. Avec le backend Wildcard, si la requête wildcard n’affiche rien, les applications échoueront plus tard alors que le dashboard fonctionnera correctement.
Si le domaine est derrière Cloudflare, définissez les enregistrements en mode DNS uniquement. Le proxy ne relaie que le trafic HTTP et HTTPS, ce qui interrompt les ports de messagerie. Pour les applications web proxifiées, la vue Network de Cloudron permet de faire confiance aux plages d’adresses IP publiées par Cloudflare afin de récupérer l’adresse du visiteur à partir des en-têtes transmis.
Exécuter le script d’installation
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupExécutez-le en tant que root ou avec sudo, car il affiche sinon This script should be run as root. dès le début. L’installation prend plusieurs minutes et reste silencieuse pendant son exécution, car la sortie d’apt et les téléchargements Docker sont écrits dans un fichier journal. Surveillez-la depuis une deuxième session SSH :
tail -f /var/log/cloudron-setup.logLors de la vérification de l’installateur du 13 octobre 2026, celui-ci a affiché After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. suivi de l’adresse du serveur, puis a demandé The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Répondez yes. Cet installateur fournissait également une option --skip-reboot pour différer le redémarrage.
Premier démarrage : domaine, backend DNS et compte administrateur
Ouvrez https://<server-ip> et acceptez l’avertissement du navigateur. Le certificat est auto-signé, car Cloudron ne connaît pas encore votre domaine et ne peut donc pas demander de certificat à une autorité de certification. Dans Chrome, cliquez sur Advanced, puis sur Proceed to <ip> (unsafe). Dans Firefox, cliquez sur Advanced, puis sur Accept the Risk and Continue.
Le premier écran vous demande votre domaine. Saisissez example.com. Le dashboard est ensuite accessible à l’adresse my.example.com. Vous pouvez aussi utiliser un sous-domaine, par exemple cloudron.example.com. Le dashboard sera alors accessible à l’adresse my.cloudron.example.com. Sélectionnez le backend DNS, collez le token API si vous en avez un, puis créez le compte administrateur avec une adresse e-mail que vous consultez réellement : les réinitialisations de mot de passe et les notifications de la plateforme l’utilisent.
Lorsque vous enregistrez la configuration, Cloudron demande les certificats et déplace le dashboard vers https://my.example.com. L’URL basée sur l’adresse IP ne fonctionne alors plus. Ajoutez la nouvelle URL à vos favoris.
Certificats : ce qui est renouvelé et quand le renouvellement s’arrête
Le renouvellement des certificats est automatique et suit les informations de renouvellement ACME (ARI), c’est-à-dire le calendrier publié par l’autorité de certification. En pratique, le renouvellement a généralement lieu environ un mois avant l’expiration. En cas d’échec, un e-mail est envoyé au compte administrateur. Si le certificat expire, le système utilise le certificat auto-signé intégré. C’est ce mécanisme qui explique l’avertissement du navigateur sur un site qui fonctionnait encore la veille.
Deux causes expliquent la plupart des problèmes. La validation HTTP nécessite le port entrant 80. Fermer le port 80 parce que « tout est déjà en HTTPS » empêche donc le renouvellement des applications qui utilisent la validation HTTP de Let's Encrypt avec un backend Wildcard ou DNS manuel. La validation DNS nécessite un API token qui conserve les droits d’écriture. La rotation ou la restriction de ce token interrompt donc silencieusement le renouvellement, jusqu’à l’envoi de l’e-mail d’avertissement.
La vue Domains contient un bouton Renew All qui permet de lancer immédiatement la tentative. Elle propose également un provider Let's Encrypt Staging pour les tests. Les certificats Staging ne sont volontairement pas approuvés par les navigateurs. C’est précisément l’objectif : les tests évitent de consommer les limites de débit de la production. Staging applique ses propres limites, notamment 200 échecs d’autorisation par identifiant, par compte et par heure.
Faut-il utiliser le serveur de messagerie intégré ?
Cloudron fournit une stack mail complète avec des boîtes aux lettres IMAP, la soumission SMTP, des filtres Sieve et la signature DKIM (DomainKeys Identified Mail). Vous l’activez pour chaque domaine dans la section Email du tableau de bord. Le plus difficile reste de faire distribuer les messages, et ces difficultés ne viennent pas de Cloudron.
- Le port sortant 25 est bloqué par la plupart des fournisseurs de VPS pour limiter le spam. Certains le débloquent après l’ouverture d’un ticket auprès du support. Testez-le depuis le serveur avec
nc -zv aspmx.l.google.com 25(installeznetcat-openbsdsi la commande est absente). Le rapport des ports ouverts est affiché parsucceeded, et une connexion vers un port bloqué reste en attente jusqu’à expiration du délai. - L’enregistrement PTR (DNS inverse) est défini par votre fournisseur de VPS, et non par votre hébergeur DNS. Il doit correspondre au nom d’hôte de messagerie lorsque vous envoyez directement depuis le serveur. Un smart host supprime cette exigence liée au PTR.
- Les enregistrements SPF, DKIM et DMARC sont créés pour vous sur un backend DNS avec API. Avec les backends Wildcard ou Manual, vous devez les ajouter manuellement. Si l’enregistrement DKIM manque, aucun message que vous signez ne peut être vérifié.
Pour la plupart des utilisateurs, la configuration la plus fiable consiste à recevoir les messages sur Cloudron et à les envoyer via un relay tel que SendGrid, Postmark, Mailgun ou Amazon SES, configuré dans la vue Email. Le relay doit autoriser l’envoi avec n’importe quelle adresse de votre domaine. Sinon, les notifications d’applications provenant de différents expéditeurs sont rejetées. Si la messagerie est la raison principale pour laquelle vous achetez le serveur, exécutez un serveur de messagerie dédié tel que Mailcow sur une machine distincte, avec sa propre réputation IP.
Si vous n’utilisez pas du tout Cloudron Email, bloquez les ports 25, 465, 587, 993 et 4190 dans le firewall de votre fournisseur. Faites-le à cet endroit, et non sur le serveur, car Cloudron écrit lui-même les règles iptables et s’attend à les gérer. C’est l’inverse d’un VPS classique, où vous gérez vous-même les règles ufw.
Configurez la cible de sauvegarde avant d’en avoir besoin
Par défaut, les sauvegardes sont stockées sur le système de fichiers local, dans /var/backups, sur le même disque que le reste. La documentation est claire : « Stocker les sauvegardes sur le même disque physique que le serveur de la plateforme est dangereux. » Une panne de disque entraîne la perte des applications et des sauvegardes.
Ouvrez Backups, puis Backup Sites, et configurez dès le premier jour une autre cible. Un stockage d’objets compatible S3 est généralement le meilleur choix (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces ou un bucket MinIO sur un second serveur). SSHFS, NFS, CIFS et les cibles utilisant directement le système de fichiers sont également pris en charge.
Trois paramètres déterminent l’utilité de cette sauvegarde :
- Format.
tgzcrée une archive compressée par application et la téléverse à nouveau en entier à chaque exécution.rsyncne téléverse que les fichiers modifiés. Cette option coûte beaucoup moins cher pour un Nextcloud volumineux, mais génère beaucoup plus de requêtes vers l’API de stockage. - Chiffrement. Chiffrement AES-256 facultatif couvrant le contenu des fichiers et leurs noms. Cloudron ne conserve pas de copie du mot de passe. Si vous le perdez, personne ne pourra déchiffrer les sauvegardes, vous compris. Stockez-le dans un gestionnaire de mots de passe auto-hébergé avant de cliquer sur Save.
- Rétention. Elle est définie par des quantités, par exemple 7 sauvegardes quotidiennes et 4 hebdomadaires. Une longue rétention sur un stockage d’objets augmente votre facture chaque mois. Choisissez donc un nombre que vous acceptez de continuer à payer.
Testez ensuite une restauration. Installez une petite application, restaurez-la depuis le dashboard et vérifiez qu’elle revient avec ses données. Une sauvegarde qui n’a jamais été restaurée est une simple hypothèse.
Ce que limite l’offre gratuite
En octobre 2026, l’offre gratuite est limitée à deux applications installées. Elle inclut tout le reste : les mises à jour des applications, les sauvegardes par application, le pare-feu, le serveur de messagerie et le single sign-on. C’est à partir de la troisième application qu’une licence devient nécessaire. Les offres payantes suppriment la limite d’applications. L’offre supérieure ajoute les groupes et rôles d’utilisateurs, un serveur d’annuaire et plusieurs sites de sauvegarde. Les prix évoluent. Consultez donc la page des tarifs de Cloudron plutôt qu’un montant indiqué dans un tutoriel.
Une licence couvre une installation Cloudron. Deux petits serveurs coûtent donc deux fois plus cher qu’un seul serveur plus puissant. Cette tarification pousse la plupart des utilisateurs à choisir un seul VPS plus grand, contrairement au conseil habituel de répartir les services entre plusieurs machines. Dimensionnez le serveur en conséquence, car séparer les services plus tard revient à payer deux fois.
Quand quelque chose ne fonctionne plus
Commencez par le contrôle intégré. Il vérifie successivement le DNS, les certificats, le disque, la mémoire et chaque service, puis indique quel test a échoué :
sudo cloudron-support --troubleshootUtilisez ensuite les outils systemd standard (gestionnaire du système et des services). systemctl status box affiche l’état du service Cloudron lui-même, journalctl -u box -n 100 ses journaux récents et journalctl -u docker l’environnement d’exécution des conteneurs sous-jacent. Tout problème survenu pendant l’installation est consigné dans /var/log/cloudron-setup.log.
Un tableau de bord qui ne se charge pas indique généralement un problème de DNS ou de pare-feu du fournisseur, plutôt qu’un problème Cloudron. Exécutez dig +short my.example.com depuis votre ordinateur portable et vérifiez que les ports 80 et 443 sont ouverts dans le pare-feu réseau du fournisseur. Il s’agit d’un contrôle distinct des règles du serveur lui-même. Lors du contrôle de l’installateur du 13 octobre 2026, une seconde exécution a été refusée avec Error: Cloudron is already installed. To reinstall, start afresh ; reconstruire le serveur est la solution propre.
Quand Cloudron n’est pas adapté
Cloudron convient lorsque vous voulez déployer des applications plutôt que gérer l’infrastructure. Il convient mal lorsque vous voulez exécuter vos propres conteneurs comme vous l’entendez, car il prend en charge nginx, Docker et le firewall, puis écrase les modifications que vous y apportez. Si votre projet consiste à gérer un répertoire de fichiers Compose, Traefik devant vos propres stacks Docker Compose fournit le même TLS automatique et le même routage par sous-domaine, sans plateforme par-dessus. Si vous n’avez pas encore choisi, Cloudron, CasaOS et Coolify comparés les présente côte à côte, et la liste plus large des services à auto-héberger constitue un meilleur point de départ qu’un guide d’installation.
FAQ
De quelle quantité de RAM Cloudron a-t-il besoin sur un VPS ?
Le contrôle de l’installateur du 13 octobre 2026 refusait de s’exécuter avec moins de 941 MB. La documentation actuelle demande 2 GB, mais il s’agit du minimum pour la plateforme sans aucune application. Cloudron exécute Docker, nginx, son propre service box et la pile de messagerie. Il provisionne aussi des services de base de données partagés lors du déploiement des applications. Prévoyez 4 GB pour deux applications et 16 GB pour environ dix applications. Ajoutez un fichier swap, car Cloudron autorise une quantité illimitée de swap pour les applications. Un serveur sans swap transforme la pression mémoire en redémarrages.
Puis-je installer Cloudron sur Debian ou sur un serveur qui exécute déjà Docker ?
Aucune de ces options ne fonctionne. Lors du contrôle de l’installateur du 13 octobre 2026, le script s’arrêtait pour les versions non prises en charge avec Cloudron requires Ubuntu 22.04, 24.04, 26.04. Il refusait aussi les serveurs où nginx, docker ou node étaient déjà présents. La documentation d’installation actuelle exige une image Ubuntu vierge et exclut Debian, Rocky et Alpine. Partez d’une image Ubuntu vierge sur un VPS KVM.
Pourquoi les sous-domaines de mes applications échouent-ils alors que le tableau de bord fonctionne ?
Sur le backend Wildcard, vérifiez l’enregistrement DNS wildcard. L’installation crée ou exige un enregistrement A pour my.example.com. Le tableau de bord se résout donc correctement, tandis que wiki.example.com renvoie NXDOMAIN et que le navigateur indique que le site est introuvable. Ajoutez un enregistrement A pour *.example.com qui pointe vers l’adresse IP du serveur, puis vérifiez-le avec dig +short wiki.example.com avant d’installer l’application.
Dois-je utiliser le serveur de messagerie Cloudron ?
Non. Vous pouvez désactiver la réception des e-mails et envoyer les messages via un relay externe comme Postmark, Mailgun ou Amazon SES. C’est le choix le plus sûr lorsque votre fournisseur bloque le port sortant 25 ou lorsque l’adresse IP n’a pas encore de réputation d’envoi. Si vous désactivez complètement Cloudron Email, fermez les ports 25, 465, 587, 993 et 4190 dans le firewall du fournisseur, plutôt que sur le serveur.
Que se passe-t-il lorsque j’atteins la limite de deux applications du forfait gratuit ?
Vous avez besoin d’un abonnement payant pour installer une troisième application. Les applications déjà exécutées ne sont pas modifiées : elles continuent de se mettre à jour et d’être sauvegardées, et leurs certificats restent actifs. L’ajout d’un abonnement lève la limite sans réinstaller quoi que ce soit. Le forfait gratuit permet donc de tester correctement la plateforme sur un domaine réel.