My home server got unplugged, so I built a recovery CLI

À propos de My home server got unplugged, so I built a recovery CLI

HomeButler est un outil CLI et serveur MCP conçu pour la récupération et l’administration de serveurs domestiques et de laboratoires informatiques (homelabs). Distribué sous forme d’un binaire unique, il permet de surveiller l’état des serveurs, de gérer Docker, de réveiller des machines via Wake-on-LAN (WOL), de scanner le réseau local et d’exposer ces fonctionnalités par l’entremise de multiples interfaces : CLI, JSON, tableau de bord Web, TUI (interface texte) ou outils d’intelligence artificielle comme Claude, ChatGPT et Cursor via le protocole MCP. L’outil a été spécifiquement développé en réponse à un incident domestique, d’où son orientation marquée vers la reprise après sinistre et la vérification de l’état des infrastructures.

Fonctionnalités principales

• Surveillance système : suivi du CPU, de la mémoire, de l’espace disque, du temps d’activité (uptime) et de l’état général des serveurs.
• Gestion Docker : liste, redémarrage, arrêt et consultation des journaux (logs) des conteneurs.
• Déploiement d’applications auto-hébergées : installation en une commande d’applications telles que Uptime Kuma, Jellyfin, Pi-hole, Gitea et Portainer.
• Administration multi-serveur : pilotage de serveurs distants par SSH, avec authentification par clé ou mot de passe.
• Alertes : notifications lorsque des seuils de ressources sont dépassés.
• Sauvegarde et restauration : sauvegarde et restauration des volumes Docker, incluant les fichiers Compose et les variables d’environnement.
• Wake-on-LAN : démarrage à distance de machines configurées.
• Scan réseau et ports : découverte des appareils sur le réseau local, identification des ports ouverts et des processus associés.
• Interfaces multiples : accès via CLI, sortie JSON, tableau de bord Web, TUI terminal et intégration MCP.
• Doctor check : diagnostic de santé qui vérifie l’exposition publique, l’hygiène des sauvegardes et la préparation à la reprise après incident.
• Détection de crashs et redémarrages : suivi des journaux avant et après un redémarrage, détection de boucles de flapping.
• Vérification des sauvegardes : test de restauration dans des conteneurs isolés avant de faire confiance aux sauvegardes existantes.

Tarification

Les sources disponibles n’indiquent aucun prix officiel, aucun plan payant ni page tarifaire pour HomeButler. Le dépôt GitHub et la documentation du paquet Go décrivent l’outil et sa version la plus récente, mais ne mentionnent pas de grille tarifaire.

• Plans : non indiqués dans les informations fournies.
• Prix : non indiqués dans les informations fournies.
• Statut probable : d’après la distribution sous forme de binaire unique et la présence d’un dépôt GitHub, HomeButler s’apparente à un outil open-source ou auto-hébergé plutôt qu’à un service SaaS tarifé. Il s’agit toutefois d’une inférence basée sur les sources visibles, et non d’une confirmation officielle.

Cas d’utilisation

• Récupération après un incident domestique : remettre en ligne un serveur, vérifier son état, relancer des conteneurs et inspecter les journaux.
• Gestion d’un laboratoire informatique multi-machines : centraliser l’administration de plusieurs serveurs ou mini-PC.
• Opérations assistées par intelligence artificielle : utiliser Claude, ChatGPT ou Cursor pour exécuter des actions structurées sans donner un accès SSH brut à l’agent.
• Maintenance préventive : vérifier l’espace disque, la santé des sauvegardes, les ports exposés et les services à risque.
• Aide au support local : diagnostiquer rapidement un serveur défaillant à l’aide du doctor check ou du tableau de bord.
• Réveil de machines : allumer à distance un PC ou un serveur éteint via Wake-on-LAN.

Notre avis

HomeButler se distingue par sa légèreté et sa polyvalence. Le fait de regrouper CLI, TUI, tableau de bord Web, sortie JSON et serveur MCP dans un même binaire est un avantage certain pour les administrateurs de petits environnements. L’orientation explicite vers la reprise après sinistre et la vérification post-incident en fait un outil pertinent pour quiconque gère un serveur domestique ou un petit laboratoire informatique. La compatibilité avec les assistants IA via MCP permet d’automatiser certaines opérations sans exposer un accès SSH complet à un agent.

Sur le plan des limitations, l’absence d’information claire sur la tarification soulève des questions. Si l’outil est bel et bien open-source et gratuit, cette information mériterait d’être affirmée explicitement. Par ailleurs, son périmètre est clairement centré sur les environnements Docker et SSH, ce qui réduit son utilité dans des infrastructures plus hétérogènes ou de taille entreprise. Enfin, la maturité de l’outil demeure à évaluer dans un contexte de production, car les sources disponibles ne fournissent pas de métriques de disponibilité, de support ou d’accord de niveau de service.

En somme, HomeButler est un outil prometteur pour les amateurs et les petits administrateurs qui cherchent une solution légère et modulable pour surveiller et récupérer leurs serveurs domestiques, surtout s’ils utilisent déjà Docker et souhaitent intégrer des assistants IA à leurs opérations.