Une licence cPanel ne s'installe pas comme un plugin : elle est liée à l'adresse IP publique d'un serveur et à son type, virtuel ou dédié. Voici comment choisir la bonne référence, l'activer et vérifier que le serveur est correctement licencié dans WHM.
VPS ou Dedicated : la première décision
cPanel propose deux éditions. cPanel VPS s'applique à un serveur virtuel (KVM, VMware, Xen, Hyper-V) et cPanel Dedicated à une machine physique. Commander la mauvaise édition bloque l'activation. Identifiez donc le type de machine avant toute chose :
systemd-detect-virt
Une sortie kvm, vmware ou xen désigne un serveur virtuel ; l'absence de sortie indique une machine physique. cPanel ne s'installe pas sur un conteneur OpenVZ ou LXC : dans ce cas, choisissez un autre panneau ou migrez vers un serveur KVM.
Vérifier le serveur avant de commander
- Distribution supportée : AlmaLinux, Rocky Linux ou CloudLinux en version à jour.
- Nom d'hôte pleinement qualifié et résolvable, par exemple
srv1.exemple.com. - Adresse IPv4 publique fixe, avec les ports 2087 (WHM) et 2083 (cPanel) accessibles.
- Aucun autre panneau ni serveur web en conflit déjà installé.
- Ressources suffisantes : prévoyez au moins 2 Go de RAM et de l'espace disque libre pour les comptes et les sauvegardes.
hostname -f
ip -4 addr show scope global
Commander la licence
Dans la boutique OpenVista, ouvrez la fiche cPanel VPS ou cPanel Dedicated, indiquez la quantité, puis validez le panier. Précisez l'adresse IP du serveur dans les notes de commande : la licence est émise pour cette adresse. Après paiement, la référence et la facture apparaissent dans votre espace client.
Installer cPanel sur un serveur neuf
Connectez-vous en root, placez-vous dans /home et lancez l'installateur officiel :
cd /home
curl -o latest -L https://securedownloads.cpanel.net/latest
sh latest
L'installation prend plusieurs dizaines de minutes et redémarre les services. Une fois terminée, cPanel récupère la licence associée à l'adresse IP du serveur. Contrôlez la version installée avec :
/usr/local/cpanel/cpanel -V
Activer et vérifier la licence dans WHM
Ouvrez WHM à l'adresse https://adresse-du-serveur:2087 et connectez-vous en root. La page d'information de licence affiche l'édition, l'adresse IP associée et la date d'expiration : elles doivent correspondre à la commande. Si la licence n'est pas reconnue, vérifiez l'IP publique et le type de machine, puis forcez une mise à jour du panneau :
/usr/local/cpanel/scripts/upcp
/usr/local/cpanel/scripts/restartsrv_cpsrvd
Si l'anomalie persiste, ouvrez un ticket avec l'IP publique, la date de commande et le type de serveur : la licence peut être réémise côté fournisseur.
Cas courants : IP, édition et expiration
- Changement d'adresse IP : la licence est liée à l'IP, demandez sa réémission avant la bascule.
- Passage d'un VPS à un serveur dédié : commandez l'édition Dedicated et résiliez l'ancienne.
- Renouvellement : renouvelez avant l'échéance pour éviter la suspension du panneau.
- Plusieurs serveurs : une licence par machine, avec la quantité correspondante.