Installation

Prérequis

Un VPS neuf, x86_64, avec 2 Go de RAM au minimum (4 Go avec --full).
Debian 12/13 ou Ubuntu 22.04/24.04/26.04 pour une installation directe. Sur AlmaLinux, Rocky, RHEL, Oracle Linux, CentOS Stream, Fedora, openSUSE, Arch ou Alpine, le panneau s'installe dans un conteneur, avec la même commande.
Un nom d'hôte qui pointe vers l'IP du VPS.
Ces ports ouverts chez l'hébergeur : 22, 80, 443, 8083 (panneau), 9443 (gateway), 2222 (SSH des clients), 25/465/587 et 993/995 (mail).

Obtenir CentraleHost

Le code source n'est pas public : contactez Centrale Technologies pour obtenir un accès.

Installer

Depuis le dossier du code, en root :

bash install-centralehost.sh --hostname panel.exemple.cd --email admin@exemple.cd \
     --city Kinshasa --lat -4.32 --lon 15.31

À la fin, l'installeur affiche l'adresse du panneau et les identifiants, aussi envoyés à l'adresse --email. Connectez-vous aussitôt : le panneau peut imposer un changement de mot de passe à la première connexion.

Option	Effet
`--username <nom>`	Compte administrateur (`admin` par défaut)
`--password <mdp>`	Mot de passe administrateur choisi
`--zone <domaine>`	Zone des aperçus et des environnements
`--full`	Ajoute ClamAV et SpamAssassin
`--no-envs`, `--no-gateway`, `--no-crowdsec`	Installe sans cette brique

Reprendre une installation interrompue

Si l'installation s'arrête après la base du panneau, corrigez la cause, puis relancez :

bash install-centralehost.sh --update

Si elle s'arrête plus tôt, repartez d'un serveur neuf.

Installer dans un conteneur

Ce mode est choisi automatiquement hors des systèmes listés pour l'installation directe. Pour le demander :

bash install-centralehost.sh --container --hostname panel.exemple.cd --email admin@exemple.cd

Ne déplacez pas le dossier du code ensuite, et ne recréez pas le conteneur : il contient les comptes, les sites, les mails et les bases.

Après l'installation

Mail : publiez SPF, DKIM et DMARC, et demandez le DNS inverse de l'IP à votre hébergeur. Sans ça, vos mails risquent de partir en spam.
Relais d'envoi : connectez-en un si Gmail refuse l'IP du serveur. Voir Gabriel.
Clients : créez vos forfaits, puis vos comptes. Chaque compte reçoit son environnement selon son forfait.

Faites un essai sur un VPS de test avant d'y mettre des clients. Le gateway et les environnements clients n'ont pas encore été déroulés de bout en bout sur une machine neuve.