⚙️ Administration - NcStatusCheck

Configuration des versions de référence et gestion des serveurs

Modes de collecte des données

Chaque serveur peut utiliser un ou plusieurs modes de collecte, non exclusifs :

Mode Badge Source Données collectées Configuration requise
Basic (aucun) /status.php Version Nextcloud uniquement Aucune — fonctionne dès l'ajout du serveur
Étendu Étendu /ocs/v2.php/apps/serverinfo/… Version NC, PHP, serveur web, OPcache, Redis, base de données, utilisateurs actifs… Token serverinfo à renseigner dans la zone "Sondes" de la carte serveur
Push 📡 Push Script cron sur l'instance distante Même données qu'Étendu + mises à jour Docker disponibles + résultats occ setupchecks Générer un token Push depuis la carte serveur, puis déployer le script bash sur l'instance Nextcloud

Gestion des serveurs

Ajoutez ou supprimez des serveurs Nextcloud à surveiller :

Le token est disponible dans Paramètres Nextcloud → Administration → Informations système. Sans token, seule la version Nextcloud est collectée via /status.php.

🛠️ Sonde Étendue — configurer et tester le token serverinfo

⚠️ L'application Monitor doit être activée dans Nextcloud pour que l'API serverinfo fonctionne. Vérifier dans Paramètres → Applications → Outils système → Monitor (ou via occ app:enable serverinfo).

ℹ️ Adapter le chemin /var/www/cloud/occ selon l'emplacement de votre instance Nextcloud (ex : /var/www/nextcloud/occ, /opt/nextcloud/occ…).

1. Générer et définir un token :
TOKEN=$(openssl rand -hex 32) && \
sudo -u www-data php /var/www/cloud/occ config:app:set serverinfo token --value "$TOKEN" && \
echo "Token généré : $TOKEN"
2. Vérifier le token en place :
sudo -u www-data php /var/www/cloud/occ config:app:get serverinfo token
3. Supprimer le token :
sudo -u www-data php /var/www/cloud/occ config:app:delete serverinfo token
4. Tester l'API serverinfo (debug) :
wget -qO- --header="NC-Token: VOTRE_TOKEN" "https://cloud.example.com/ocs/v2.php/apps/serverinfo/api/v1/info?format=json"

Remplacer VOTRE_TOKEN et l'URL par ceux du serveur concerné. Une réponse JSON valide confirme que le token et l'app Monitor sont corrects.

Serveurs surveillés :

Versions Nextcloud

Configurez les versions de référence pour chaque branche Nextcloud :

Nom de la branche
Version minimale
Label d'affichage
Statut
Action

Versions PHP

Configurez les versions PHP supportées :

Version PHP
Version minimale
Label d'affichage
Statut
Action