Installer CloudPanel sur un VPS Linux (Ubuntu/Debian)

CloudPanel est un panel de gestion gratuit et léger qui pilote Nginx, PHP-FPM, les bases de données et les certificats SSL depuis une interface web. Installé sur un VPS Linux Infrawire, il transforme un serveur vide en plateforme d'hébergement multi-sites en quelques minutes. Ce guide couvre Ubuntu 24.04 et Debian 12.

📋 Prérequis

Un VPS KVM tout neuf sous Ubuntu 24.04 ou Debian 12, sans rien d'autre d'installé (ni Apache, ni Nginx, ni MySQL, ni autre panel).
Au moins 2 Go de RAM et un accès SSH root. Depuis votre espace client, vous retrouvez l'IP et le mot de passe root du VPS.
Un nom de domaine dont l'enregistrement DNS A (et AAAA si vous utilisez l'IPv6) pointe vers VPS_IP.
Les ports 22, 80, 443 et 8443 accessibles depuis Internet.

🔄 1. Préparer le système

Connectez-vous en root et mettez les paquets à jour. CloudPanel a besoin de curl, wget et sudo.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

Si le noyau a été mis à jour, redémarrez avec reboot et reconnectez-vous avant de continuer.

⬇️ 2. Lancer l'installateur officiel

L'installateur est d'abord téléchargé, puis sa somme de contrôle SHA-256 est vérifiée avant exécution. Cette somme change à chaque version de l'installateur : copiez la valeur actuelle et la liste à jour des moteurs de base de données depuis la page officielle https://www.cloudpanel.io/docs/v2/getting-started/other/ (remplacez SHA256_FROM_DOCS ci-dessous).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

La variable CLOUD_PANEL_DB_ENGINE choisit le serveur de base de données. Les valeurs documentées sont MYSQL_8.4, MYSQL_8.0, MARIADB_11.4 et MARIADB_10.11. Sans elle, l'installateur utilise son choix par défaut. La commande sha256sum -c doit afficher install.sh: OK ; si elle affiche FAILED, arrêtez-vous et retéléchargez le fichier. L'installation dure quelques minutes.

🔑 3. Créer le premier compte administrateur

Ouvrez https://VPS_IP:8443 dans votre navigateur. Le certificat est auto-signé, le navigateur affiche donc un avertissement : acceptez-le pour cette première connexion.

Le premier visiteur crée l'administrateur, faites-le donc immédiatement. Renseignez le nom d'utilisateur, l'adresse e-mail et un long mot de passe, puis connectez-vous. Ne laissez pas le panel exposé pendant des heures avant de créer le compte.

🌐 4. Ajouter un site PHP

Dans le panel, cliquez sur Sites, puis Add Site, puis Create a PHP Site. Choisissez un modèle d'application (Generic, WordPress, Laravel, etc.), saisissez example.com comme domaine, sélectionnez une version de PHP et définissez l'utilisateur et le mot de passe du site. CloudPanel crée le vhost Nginx, un pool PHP-FPM et un utilisateur système dédié au site.

Envoyez vos fichiers en SFTP avec l'utilisateur du site (pas root), dans /home/USER/htdocs/example.com. Vous pouvez aussi créer une base de données pour le site dans Databases.

🔒 5. Émettre un certificat Let's Encrypt

Vérifiez que example.com pointe déjà vers VPS_IP :

Bash
1dig +short example.com

Ouvrez ensuite le site, allez dans l'onglet SSL/TLS, cliquez sur Actions puis New Let's Encrypt Certificate. Sélectionnez les noms de domaine à inclure et validez. Le renouvellement est géré automatiquement par CloudPanel.

🛡️ 6. Sécuriser le panel

Dans Admin Area > Security > Firewall, limitez le port 8443 à votre propre adresse IP et supprimez la règle qui l'autorise depuis partout. Gardez 22, 80 et 443 ouverts selon vos besoins.
Dans Admin Area > Security, activez le Basic Auth du panel comme seconde barrière.
Dans votre profil utilisateur, activez l'authentification à deux facteurs.
Utilisez un mot de passe long et unique, et gardez le système à jour :

Bash
1apt update && apt -y upgrade

✅ 7. Vérifier l'installation

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

Les ports 80, 443 et 8443 doivent être en écoute, les deux services doivent répondre active, et la dernière commande doit renvoyer un code HTTP 200 ou une redirection avec un certificat valide.

🧰 Dépannage

L'installateur refuse de démarrer ou échoue en cours de route : CloudPanel doit être installé sur un système propre. Si un autre serveur web ou une base de données était déjà présent, réinstallez l'OS depuis votre espace client et recommencez.
Le port 8443 ne répond pas : vérifiez que le pare-feu (règles du panel et tout autre pare-feu) l'autorise, et que votre IP n'a pas été retirée de la liste autorisée. Lancez ss -tlnp | grep 8443 sur le serveur.
Let's Encrypt échoue : le domaine ne pointe pas encore vers le VPS, ou un proxy masque la vraie IP. Corrigez l'enregistrement DNS, attendez la propagation et réessayez. Le port 80 doit être ouvert.
Mot de passe admin perdu : réinitialisez-le depuis le shell avec clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD'.

🎉 CloudPanel est opérationnel : ajoutez vos sites, sécurisez le port 8443 et profitez d'une pile d'hébergement propre sur votre VPS.