Skip to content

Bare Metal Install FR

Kheopsian edited this page Jul 30, 2026 · 1 revision

🇬🇧 English(Bare-Metal-Install) · 🇫🇷 Français

Installation bare-metal (sans Docker)

Pas envie de Docker ? Les releases tagguées fournissent un tarball Linux autonome. L'UI web est embarquée dans le binaire : rien à traîner à côté — juste deux binaires, une config et une unité systemd.

Téléchargement

Récupère le tarball de ton architecture sur la page Releases :

  • hydra-vX.Y.Z-linux-amd64.tar.gz (Intel/AMD)
  • hydra-vX.Y.Z-linux-arm64.tar.gz (ARM, ex. Pi 4/5 ou VPS ARM)

Chacun a un .sha256 pour vérifier : sha256sum -c hydra-*.tar.gz.sha256.

Installer en service (recommandé)

tar xzf hydra-vX.Y.Z-linux-amd64.tar.gz
cd hydra-vX.Y.Z-linux-amd64
sudo ./install.sh

install.sh pose les binaires dans /opt/hydra, la config dans /etc/hydra, les données dans /var/lib/hydra, crée un utilisateur système dédié hydra, et fait systemctl enable --now hydra. Hydra démarre alors au boot et se relance en cas de crash.

L'UI est sur http://<host>:8199. Le mot de passe admin s'affiche une seule fois au premier démarrage :

journalctl -u hydra | grep -i password

Gère-le avec les commandes systemd habituelles :

systemctl status hydra
systemctl restart hydra
journalctl -u hydra -f          # logs en direct

Le lancer à la main (sans systemd)

Pour un test rapide, un NAS sans systemd, ou ton propre superviseur :

./hydra --config ./default.toml.example

Hydra trouve son moteur (hydra-engine) placé à côté du binaire hydra automatiquement. Pour le mettre ailleurs : HYDRA_ENGINE_BIN=/chemin/hydra-engine.

Contenu du tarball

hydra                  # le binaire Go (UI + API, assets embarqués)
hydra-engine           # le moteur BitTorrent Typhon (Rust)
default.toml.example   # config d'exemple commentée
hydra.service          # l'unité systemd utilisée par install.sh
install.sh             # l'installeur ci-dessus

Mise à jour

Télécharge le nouveau tarball, décompresse, et relance sudo ./install.sh. Il met les binaires à jour en place et ne touche jamais à /etc/hydra ni /var/lib/hydra : ta config, tes resume data et ton store de torrents sont conservés.

Notes

  • Les données vivent dans /var/lib/hydra (le data_dir de la config), séparées des binaires — c'est cette séparation qui rend les MAJ sûres.
  • Le même binaire fait toutes les topologies : ajoute --front-only ou --agent-only ... dans la ligne ExecStart= de hydra.service (ou la commande manuelle) pour un contrôleur ou un nœud agent au lieu d'un monolithe. Voir Topologies de déploiement.
  • Derrière un VPN, pas besoin des acrobaties réseau de Docker — le process voit directement les interfaces de l'hôte. Voir Gluetun (VPN) pour l'histoire des ports.

Build depuis les sources

Nécessite Rust et Go 1.25 :

cargo build --release --manifest-path typhon-engine/Cargo.toml --bin typhon-engine
go build -ldflags="-s -w" -o hydra ./cmd/hydra

Puis place typhon-engine/target/release/typhon-engine à côté de hydra sous le nom hydra-engine (ou pointe HYDRA_ENGINE_BIN dessus).

Clone this wiki locally