Jeehelp – un assistant Jeedom en ligne de commande

Utilisation du core de Jeedom
1

Bonjour à tous,

Je partage jeehelp, un outil en ligne de commande pour administrer une box Jeedom. Il regroupe en un seul menu ce qu’on refait souvent en SSH : sauvegardes, base de données, droits, services, logs, mises à jour… avec un mode de secours quand l’interface web ne répond plus.

Menu principal de jeehelp

:warning: Version bêta : à tester avec précaution

  • C’est une bêta. Je l’utilise sur ma box, mais elle n’a pas été éprouvée sur beaucoup d’installations.
  • Il tourne en root et certaines actions modifient le système (droits, restauration, import SQL, REPAIR TABLE, mises à jour, désactivation de plugins/cron…). Chaque action sensible demande une confirmation, mais faites une sauvegarde avant et lisez le script avant de l’installer.
  • Testé sur Debian 13 / Jeedom 4.6.2 / MariaDB 11.8. Debian 11 et 12 ne sont pas testées.
  • À essayer d’abord sur une box de test si possible.

**C’est le résultat d’un travail de longue haleine avec l’IA :

Ce qu’il fait

  • Particulièrement utile si l’interface n’est plus joignable.
  • Santé et rapport de diagnostic : état du core (cron, scénarios), MariaDB (serveur, base, schéma, datadir), plugins actifs et leurs daemons, ressources, erreurs PHP par plugin, accessibilité de l’interface et de la page de secours… avec une synthèse des erreurs et avertissements. Le rapport ne contient aucun secret.
  • Sauvegardes (créer, lister, restaurer, rotation), base de données (ANALYZE/REPAIR/OPTIMIZE, dump, import), services, logs, réseau/SSL, mises à jour (dont unattended-upgrades), nettoyage.
  • Mode secours quand l’interface est injoignable : test de la page rescue, désactivation de tous les plugins (liste journalisée pour pouvoir les réactiver), activation/désactivation du système cron. Tout est journalisé dans log/.
  • Rétablissement des droits identique au bouton du core.
  • Mode CLI non interactif (cron/scripts) : --check, --health, --report, --fix-perms… avec des codes retour exploitables.
  • Analyse du rapport par IA (optionnelle) : l’IA propose un diagnostic et des actions, elle n’exécute rien (chaque action demande votre confirmation). Avec rapport anonymisé (IP, hôte, chemins, logs retirés) et accord explicite par fournisseur. Fonctionne via le plugin ai_assistant.

Installation

  • Se connecter en ssh à Jeedom et :
curl -fsSL https://raw.githubusercontent.com/limad/jeehelp/beta/install.sh | sudo bash

Lancement

  • Se connecter en ssh à Jeedom et :
sudo jeehelp
  • Ou directement depuis un terminal (PowerShell,…)
    remplacer <votre-user> et 192.168.1.XX par vos propres infos
ssh -t <votre-user>@192.168.1.XX "sudo jeehelp"

Dépôt et documentation (arborescence complète du menu) : https://github.com/limad/jeehelp

Vos retours

Je cherche surtout des retours sur : la compatibilité (RPI, Atlas, autres installations), les faux positifs du diagnostic, les actions manquantes. Merci de signaler les problèmes ici ou sur GitHub.

Merci d’avance pour vos tests et retours ! :folded_hands:

4 « J'aime »