HYPHApar S33D
Documentation › Installer l'agent

Installer l'agent sous Windows

Un service Windows, « Hypha Agent », qui lit les compteurs de performance, les journaux d'événements et les services.

Ce qu'il faut

Installer en une commande

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; $env:HYPHA_API_KEY='hph_votre_cle'; iwr -useb https://hypha.s33d.fr/install/install.ps1 | iex

Le début de la ligne active TLS 1.2, absent d'office de PowerShell 5.1 sur Windows Server 2016 et 2019. La page Réglages › Installer l'agent donne cette commande toute prête.

Le script télécharge hypha-agent.exe dans C:\Program Files\Hypha, vérifie sa somme SHA-256, écrit C:\ProgramData\Hypha\hypha.yaml, puis installe et démarre le service Hypha Agent (nom court HyphaAgent), en démarrage automatique, compte LocalSystem, relancé sur échec.

Les variables HYPHA_URL, HYPHA_TAGS, HYPHA_HOSTNAME et HYPHA_FORCE_CONF jouent le même rôle que sous Linux.

Vérifier

& "C:\Program Files\Hypha\hypha-agent.exe" status
& "C:\Program Files\Hypha\hypha-agent.exe" check-config
Get-Service HyphaAgent

Ce que l'agent collecte d'office

Sur une édition de poste de travail, les services arrêtés ne sont pas signalés d'office : réglez checks.windows_auto_services: always pour les suivre.

Antivirus

Certains antivirus retiennent ou refusent le premier lancement d'un exécutable qu'ils ne connaissent pas. Si l'installation ou une mise à jour échoue avec « Accès refusé », autorisez C:\Program Files\Hypha\hypha-agent.exe. Pendant une mise à jour automatique, l'agent attend jusqu'à 3 minutes que le nouveau binaire réponde ; sinon il garde l'ancien et réessaie une heure plus tard, trois fois au plus.

Mettre à jour

Rejouez la commande d'installation, ou laissez la flotte se mettre à jour avec auto_update: true : voir Flotte et mises à jour.

Désinstaller

$env:HYPHA_UNINSTALL='1'; iwr -useb https://hypha.s33d.fr/install/install.ps1 | iex

Le service et le binaire sont retirés. C:\ProgramData\Hypha (configuration et état) reste en place.

Mise à jour : 19 novembre 2026