Installation

Ce guide vous explique comment faire une installation propre, des mises à niveau sécurisées et une désinstallation propre. Il comprend les prérequis, des exemples de commandes et des vérifications post-installation pour que tu puisses valider les services, le pare-feu et le DNS avant la mise en service.

Configuration système requise

  • Installation récente de Debian 13 (sans pile web ou messagerie préexistante)
  • Accès root sur le serveur
  • Un domaine pour le panneau et la messagerie (avec des enregistrements glue si vous hébergez le DNS)
  • PTR (DNS inversé) pour le nom d'hôte de messagerie
  • Ports ouverts : 22, 80, 443, 25, 465, 587, 993, 995, 53

Installation depuis GitHub

Exécutez le programme d'installation depuis GitHub :

curl -fsSL https://raw.githubusercontent.com/shukiv/jabali-panel/main/install.sh | sudo bash

Indicateurs facultatifs :

  • JABALI_MINIMAL=1 pour une installation du noyau uniquement
  • JABALI_FULL=1 pour forcer tous les composants facultatifs
  • --debug pour une sortie détaillée

Le programme d'installation clone le panneau vers /var/www/jabali et configure les services, nginx, SSL et les paquets système requis.

Compilation manuelle de paquets Debian

Jabali est livré sous forme de deux paquets Debian :

  • jabali-deps pour les dépendances système (nginx, PHP, DB, mail, DNS, etc.)
  • jabali-panel pour l'application du panneau et les services systemd

Compilez les paquets à partir de la racine du référentiel :

./scripts/build-jabali-deps-deb.sh
./scripts/build-jabali-panel-deb.sh

Installez-les sur le serveur :

sudo dpkg -i ./jabali-deps_<version>_all.deb
sudo apt-get -f install -y
sudo dpkg -i ./jabali-panel_<version>_all.deb

Après l'installation, les services systemd sont activés et démarrés :

  • jabali-agent
  • jabali-queue
  • jabali-health-monitor

URL post-installation

  • Panneau d'administration : https://your-host/jabali-admin
  • Panneau utilisateur : https://your-host/jabali-panel
  • Webmail : https://your-host/webmail

Mises à niveau

Si vous avez installé via GitHub ou la compilation manuelle, depuis le répertoire du panneau :

cd /var/www/jabali
php artisan jabali:upgrade

Rechercher uniquement les mises à jour :

php artisan jabali:upgrade --check

Désinstaller

Avant de désinstaller, effectuez des sauvegardes des données du panneau et du contenu utilisateur.

Arrêter et désactiver les services :

sudo systemctl stop jabali-agent jabali-queue jabali-health-monitor
sudo systemctl disable jabali-agent jabali-queue jabali-health-monitor

Supprimer les paquets (conserver les configurations) ou purger (supprimer les configurations) :

sudo apt remove jabali-panel jabali-deps
# or
sudo apt purge jabali-panel jabali-deps

Nettoyage facultatif (supprime les fichiers et les configurations du panneau) :

sudo rm -rf /var/www/jabali
sudo rm -rf /etc/jabali
sudo rm -rf /etc/nginx/jabali
sudo rm -rf /etc/ssl/jabali
sudo rm -f /root/.jabali_db_credentials
sudo rm -f /root/jabali_credentials.txt

Si vous souhaitez supprimer la base de données du panneau et l'utilisateur :

sudo mysql -e "DROP DATABASE IF EXISTS jabali;"
sudo mysql -e "DROP USER IF EXISTS jabali@localhost;"

Dépannage

  • Si le panneau ne se charge pas, vérifiez que nginx est en cours d'exécution et que les ports 80/443 sont ouverts.
  • Vérifiez l'état du service avec systemctl status jabali-agent jabali-queue jabali-health-monitor.
  • Consultez les journaux dans storage/logs et la sortie du journal système.