HYPHApar S33D
Documentation › Administrer

Auto-hébergement

Le même logiciel que hypha.s33d.fr, sur votre machine, gratuit et sans limite. Vos mesures, journaux et traces restent dans votre base PostgreSQL.

Ce qu'il faut

Installer

mkdir hypha && cd hypha
curl -fsSLO https://hypha.s33d.fr/auto-hebergement/docker-compose.yml
curl -fsSL https://hypha.s33d.fr/auto-hebergement/env.example -o .env

Remplissez .env. Les quatre valeurs obligatoires :

HYPHA_DB_PASSWORD=     # openssl rand -hex 24
HYPHA_PUBLIC_URL=      # https://hypha.votre-domaine.fr
HYPHA_ADMIN_PASSWORD=  # mot de passe du compte « admin »
HYPHA_SECRET=          # openssl rand -hex 32

Posez le certificat, puis démarrez :

mkdir certs
cp /chemin/fullchain.pem /chemin/privkey.pem certs/
docker compose up -d

Au premier démarrage, HYPHA crée la base, l'organisation (HYPHA_ORG_NAME), le compte d'administration (HYPHA_ADMIN_LOGIN, admin par défaut) et six moniteurs de base. Ouvrez HYPHA_PUBLIC_URL et connectez-vous.

Installez ensuite les agents depuis Réglages › Installer l'agent : la commande télécharge l'agent depuis votre serveur et le relie à lui (HYPHA_URL).

Ce que contient le kit

ServiceRôle
dbPostgreSQL 18 ; données dans le volume hypha-db
migratemet le schéma à jour, puis s'arrête
apiAPI de HYPHA et réception des agents
workermoniteurs, tests synthétiques, notifications, partitions de la base
nginxinterface, binaires signés de l'agent, seul port publié (HTTPS)

Images publiques : registre-vm.s33d.fr/hypha/server et registre-vm.s33d.fr/hypha/web, en amd64 et arm64.

Réglages utiles

VariableRôle
HYPHA_SMTP_HOST, _PORT, _USER, _PASSWORD, _FROM, _SECURITYenvoi des alertes par e-mail
HYPHA_OIDC_ISSUER, _CLIENT_ID, _CLIENT_SECRETconnexion OpenID Connect, en plus des comptes locaux ; seuls les comptes invités entrent
HYPHA_VAPID_PRIVATE_KEY, HYPHA_VAPID_SUBJECTnotifications push vers les téléphones et ordinateurs : clé générée par docker compose exec api python -m hypha vapid-key (voir Application mobile) ; vide, le canal est coupé
HYPHA_LLM_URL, HYPHA_LLM_MODELvotre serveur de modèle de type Ollama, pour l'explication des pannes et le post-mortem ; vide, la fonction est coupée
HYPHA_ALLOW_PRIVATE_TARGETSautoriser les tests synthétiques et les webhooks vers des adresses internes
HYPHA_LOG_LEVELniveau du journal du serveur
HYPHA_OTEL_ENDPOINT, HYPHA_OTEL_SAMPLEtraces du serveur lui-même, par le relais OTLP d'un agent

Comptes

En auto-hébergement, les comptes sont locaux. Ajoutez-en depuis Réglages › Membres, ou en ligne de commande :

docker compose exec api python -m hypha create-user --org <slug> --login marie --role member

Mettre à jour

# dans .env : HYPHA_VERSION=<nouvelle version>
docker compose pull
docker compose up -d

Le service migrate passe les migrations avant le redémarrage de l'API. Le kit sert les binaires signés de l'agent et leur signature : vos agents se mettent à jour depuis votre serveur (voir Flotte et mises à jour).

Sauvegarder

docker compose exec -T db pg_dump -U hypha -Fc hypha > hypha-$(date +%F).dump

Licences

Le serveur et l'interface sont distribués sous licence AGPL v3, l'agent sous licence Apache 2.0. La formule Libre n'a ni limite ni facturation. Un support avec délais garantis fait partie de la formule Entreprise du service hébergé.

Mise à jour : 20 novembre 2026