Débutant20 min

Installation en 5 minutes

Installer l'agent sur macOS ou Linux, configurer le démarrage automatique, savoir désinstaller.

Choisir sa méthode d'installation

Xytherion se distribue sous forme d'un unique binaire Go compilé statiquement. Pas de runtime, pas de dépendances système. Trois méthodes d'installation selon votre situation :

Homebrew

macOS & Linux

Recommandé — gère les mises à jour

curl | bash

macOS & Linux

Une seule commande, aucun prérequis

Sources

Tous OS

Pour compiler soi-même (Go 1.26+)

Installation via curl (macOS & Linux)

bash
curl -fsSL https://raw.githubusercontent.com/OpenDojoSystems0/xytherion-core/main/install.sh | bash

Le script détecte automatiquement votre OS et architecture (darwin/linux, amd64/arm64), télécharge le bon binaire depuis les releases GitHub, l'installe dans /usr/local/bin/ et vous demande si vous souhaitez le démarrage automatique.

Démarrage automatique — le choix

À la fin de l'installation, le script pose une question :

bash
Voulez-vous que l'agent démarre automatiquement au démarrage du système ?  [o] Oui, lancer au boot (recommandé pour un serveur)  [n] Non, je le lancerai manuellement

Répondez [o] si vous installez sur un serveur de production — l'agent redémarre automatiquement après un reboot ou un crash. Répondez [n] si vous testez en local et préférez le contrôle manuel.

✦
Pour un serveur Linux de production : répondez toujours [o]. systemd s'occupera de le relancer même en cas de crash inattendu.

Vérifier l'installation

bash
xytherion --version# → xytherion v0.3.0 (linux/amd64) # Lancer l'agent (si non configuré en autostart)xytherion# → xytherion listening on :9001 (hostname: mon-serveur)

Désinstallation propre

Pour supprimer complètement l'agent (binaire, service de démarrage et données) :

bash
curl -fsSL https://raw.githubusercontent.com/OpenDojoSystems0/xytherion-core/main/uninstall.sh | bash

Le script vous demandera si vous souhaitez supprimer les données locales (~/.xytherion/) — qui contiennent les logs, vos moniteurs, vos webhooks et l'historique de 7 jours. Par défaut, elles sont conservées.

!
Ne supprimez pas manuellement le binaire sans avoir d'abord arrêté le service. Passez toujours par le script de désinstallation pour éviter des services orphelins.
✎

Exercice pratique — Vérification

  1. 1Installez l'agent avec la méthode curl.
  2. 2Lancez xytherion dans un terminal et vérifiez qu'il écoute sur le port 9001.
  3. 3Ouvrez http://localhost:9001/health dans votre navigateur — vous devez voir {"status":"ok"}.
  4. 4Si vous avez un serveur Linux, configurez le démarrage automatique avec systemd et vérifiez avec systemctl status xytherion.

Ce que vous venez d'apprendre

  • Trois méthodes : Homebrew (macOS), curl (macOS & Linux), sources (tous OS).
  • L'installeur demande si vous souhaitez le démarrage automatique au boot.
  • Sur Linux, systemd assure le redémarrage automatique en cas de crash.
  • Le script de désinstallation supprime proprement binaire, service et données.
← Module précédentPhilosophie local-first
Module suivant →Votre premier tableau de bord