HYPHApar S33D
Documentation › Installer l'agent

Installer l'agent sous Linux

Un seul binaire, sans dépendance, pour amd64 et arm64. Il tourne en service systemd et pèse moins d'un pour cent d'un cœur.

Ce qu'il faut

Installer en une commande

curl -fsSL https://hypha.s33d.fr/install/install.sh | sudo HYPHA_API_KEY=hph_votre_cle bash

Le script télécharge le binaire de votre architecture, vérifie sa somme SHA-256, écrit /etc/hypha/hypha.yaml (droits 600), pose l'unité hypha-agent.service, puis la démarre. Il ne pose aucune question et peut être rejoué : une même version ne redémarre pas le service.

Variables acceptées :

VariableRôle
HYPHA_API_KEYclé d'ingestion, obligatoire à la première installation
HYPHA_URLserveur visé, https://hypha.s33d.fr par défaut ; votre adresse en auto-hébergement
HYPHA_TAGSétiquettes ajoutées à tout ce que l'agent envoie : env:prod,role:web ou {"env":"prod"}
HYPHA_HOSTNAMEnom de l'hôte dans HYPHA (par défaut, le nom système)
HYPHA_FORCE_CONF1 réécrit api_key et url d'une configuration existante

HYPHA_TAGS et HYPHA_HOSTNAME ne servent qu'à la création du fichier : une configuration existante n'est jamais réécrite, sauf api_key et url avec HYPHA_FORCE_CONF=1.

Installer par paquet

Les paquets .deb et .rpm sont publiés à côté du binaire, sous hypha.s33d.fr/install/ :

# Debian, Ubuntu (remplacer 0.4.21 par la version de version.txt)
curl -fsSLO https://hypha.s33d.fr/install/hypha-agent_0.4.21_amd64.deb
sudo apt install ./hypha-agent_0.4.21_amd64.deb

# Red Hat, Rocky, Alma, Fedora
sudo dnf install https://hypha.s33d.fr/install/hypha-agent-0.4.21-1.x86_64.rpm

Le paquet pose la configuration d'exemple. Renseignez api_key dans /etc/hypha/hypha.yaml, puis :

sudo systemctl start hypha-agent

Un agent installé par paquet se met à jour par le gestionnaire de paquets ; le script d'installation refuse alors de le remplacer.

Vérifier

sudo hypha-agent status          # état des collecteurs et du dernier envoi
sudo hypha-agent check-config    # configuration fusionnée, secrets masqués, erreurs avec leur fichier
systemctl status hypha-agent
journalctl -u hypha-agent -n 50

L'hôte apparaît dans Infrastructure dans la minute. La page Réglages › Agents montre sa version, l'état de chaque collecteur et la dernière erreur.

Ce que l'agent collecte d'office

Tout se règle dans /etc/hypha/hypha.yaml et /etc/hypha/conf.d/*.yaml : voir la référence de configuration.

Droits et empreinte

Mettre à jour

Désinstaller

curl -fsSL https://hypha.s33d.fr/install/install.sh | sudo bash -s -- --uninstall

La configuration (/etc/hypha) et l'état (/var/lib/hypha) sont gardés. Pour tout effacer : sudo rm -rf /etc/hypha /var/lib/hypha. Un agent installé par paquet se retire par apt remove hypha-agent ou dnf remove hypha-agent.

Mise à jour : 19 novembre 2026