Aller au contenu
Documentation

Installer et exploiter Prudence

Tout ce qu'il faut pour installer Prudence sur votre hébergement sans terminal, superviser vos machines et garder l'application à jour. Version actuelle : 1.2.0.

1. Prérequis

  • PHP 8.3, 8.4 ou 8.5 avec les extensions pdo_mysql, mbstring, openssl, curl (et zip pour l'import Excel).
  • Une base MySQL 8 ou MariaDB 10.6 vide, avec un utilisateur dédié et son mot de passe (depuis votre panneau, par exemple Plesk : Bases de données → Ajouter une base ; cPanel : Bases de données MySQL).
  • Les dossiers storage/ et bootstrap/cache/ et le fichier .env inscriptibles par PHP. L'assistant le vérifie avant de commencer.

2. Installation sans terminal (hébergement mutualisé : Plesk, cPanel, Webmin, Virtualmin…)

  1. Récupérez l'archive prudence-vX.Y.Z.zip. Elle contient toutes les dépendances : Composer n'est pas nécessaire sur le serveur.
  2. Téléversez-la et extrayez-la dans votre abonnement (gestionnaire de fichiers du panneau), puis pointez la racine du document du domaine ou sous-domaine sur prudence/public et activez Let's Encrypt.
  3. Ouvrez le site : l'application prépare sa configuration et affiche le diagnostic du serveur.
  4. Suivez l'assistant : base de données (connexion testée, tables créées), application (nom, URL, fuseau), premier administrateur, messagerie (facultative), finalisation. L'assistant se ferme ensuite définitivement.
  5. Créez la tâche planifiée indiquée à la dernière étape (section suivante).
Tant que l'installation n'est pas terminée, n'importe quel visiteur peut la mener : lancez-la juste après le dépôt des fichiers.

3. Planificateur (indispensable)

La supervision repose sur une tâche lancée chaque minute.

  • Plesk : Tâches planifiées → Ajouter → Exécuter un script PHP : script …/prudence/artisan, arguments schedule:run, toutes les minutes.
  • cPanel : Tâches Cron → toutes les minutes, commande cd /home/UTILISATEUR/prudence && php artisan schedule:run >> /dev/null 2>&1.
  • Webmin / Virtualmin : Tâches planifiées (cron) → toutes les minutes, même commande avec le chemin de votre installation.
  • Certains hébergeurs limitent la fréquence des tâches : vérifiez que la vôtre peut tourner chaque minute.
  • Linux (cron) :
* * * * * cd /var/www/prudence && php artisan schedule:run >> /dev/null 2>&1

Son état est visible dans Paramètres → Application (dernière exécution).

4. Superviser une machine avec l'agent

  1. Dans Prudence : Infrastructure → Ajouter une machine. Un jeton unique est généré et affiché une seule fois.
  2. Sur la machine, installez l'agent (Python) et son service :
    • Linux : service systemd prudence-agent ;
    • Windows : install-windows.ps1 en PowerShell administrateur ;
    • macOS : install-macos.sh (launchd).
  3. La machine apparaît dans Infrastructure dès la première remontée.

5. Clé API Plesk

Sur le serveur Plesk, créez une clé limitée à l'adresse IP de Prudence :

plesk bin secret_key -c -ip-address <IP_DE_PRUDENCE> -description "Prudence"

Puis, dans Prudence : Recensement Plesk → Ajouter un serveur. Si Prudence est installé sur le serveur Plesk lui-même, cochez « Le dashboard tourne sur ce serveur Plesk » : aucune clé n'est nécessaire.

6. Mise à jour

  1. Remplacez les fichiers par ceux de la nouvelle archive, en conservant .env et storage/.
  2. Dans Paramètres → Maintenance : « Mettre à jour la base », puis « Vider tous les caches ».

7. Licence

Évaluation gratuite de 30 jours après l'installation. Ensuite, sans licence, Prudence passe en mode dégradé : collectes, contrôles et alertes critiques sont maintenus, les modifications sont verrouillées. Un super-administrateur saisit la clé dans Paramètres → Licence. La clé est liée à votre domaine et vérifiée hors ligne.

Une question ? Contactez-nous ou consultez la FAQ.