Skip to content

Windows Install FR

Kheopsian edited this page Jul 30, 2026 · 2 revisions

🇬🇧 English · 🇫🇷 Français

Installation Windows

Hydra tourne nativement sur Windows (64 bits). Les releases tagguées fournissent un zip autonome — deux fichiers .exe, une config, rien d'autre à installer. L'UI web est embarquée dans le daemon.

Téléchargement

Récupère le zip Windows sur la page Releases :

  • hydra-vX.Y.Z-windows-amd64.zip (Intel/AMD, 64 bits)

Un .sha256 l'accompagne si tu veux vérifier le téléchargement.

Le zip contient :

  • hydra.exe — le daemon (UI web + API). C'est le seul que tu lances.
  • hydra-engine.exe — le moteur BitTorrent Typhon. hydra.exe le démarre automatiquement ; tu ne le lances jamais toi-même.
  • default.toml.example — une configuration de départ.
  • README.md — une version courte de cette page.

Lancement

  1. Dézippe où tu veux, par ex. C:\Hydra.

  2. Garde hydra.exe et hydra-engine.exe dans le même dossier — le daemon cherche le moteur à côté de lui.

  3. Copie default.toml.example en default.toml et édite au minimum :

    • data_dir — un chemin Windows avec des antislashs doublés, par ex. data_dir = "C:\\Hydra\\data".
    • api_key — mets la tienne.
    • les ports, s'ils entrent en conflit avec autre chose.
  4. Lance-le depuis un terminal (PowerShell ou cmd) :

    hydra.exe --config default.toml
    
  5. Ouvre l'UI web sur http://127.0.0.1:8199 (ou le api_port que tu as mis).

C'est tout. Le daemon spawn hydra-engine.exe et lui parle via une socket TCP loopback sur 127.0.0.1 — automatique sur Windows, aucune config à faire. (Sur Linux les deux utilisent une socket Unix à la place ; même protocole, rien que tu manipules.)

Tourner en arrière-plan (comme un service)

Lancer hydra.exe depuis un terminal garde une fenêtre console ouverte. Pour le faire tourner sans surveillance et au démarrage, emballe-le dans un gestionnaire de services comme NSSM ou le sc.exe intégré. Avec NSSM :

nssm install Hydra "C:\Hydra\hydra.exe" --config "C:\Hydra\default.toml"
nssm start Hydra

Si le watchdog mémoire redémarre Hydra, le gestionnaire de services le relance.

VPN

Hydra ne gère pas le VPN sur Windows — et il n'en a pas besoin. Utilise le binding système ou par-app / kill-switch de ton client VPN (Mullvad, AirVPN Eddie, Proton, PIA, etc.). Tout le trafic d'Hydra sort alors par le tunnel comme n'importe quelle autre app.

Le routage par-socket propre à Linux (fwmark / SO_MARK, utilisé pour les setups multi-tunnel et gluetun) est désactivé sur Windows par conception — voir Gluetun (VPN) et Modes réseau pour comprendre ce que c'est et pourquoi ça ne s'applique pas ici.

Notes & limitations

  • Au premier lancement, les dossiers data/resume sont créés sous data_dir et une clé API est générée si tu l'as laissée vide — regarde la sortie console.
  • Le pare-feu Windows peut demander à autoriser hydra.exe/hydra-engine.exe à la première écoute. Autorise-le sur ton réseau privé pour que les peers t'atteignent (ou fais un port forward si tu seedes derrière un NAT).
  • Le profiling mémoire (jemalloc) est un diagnostic Linux-only, absent du build Windows ; l'allocateur système est utilisé à la place. Aucune différence fonctionnelle en usage normal.
  • Tout le reste — catégories, shim qBittorrent, ajout de torrents, seed de données existantes — marche comme sur Linux. Voir le reste du wiki.

Dépannage

  • « engine endpoint not ready » au démarrage : hydra-engine.exe n'est pas à côté de hydra.exe, ou un antivirus l'a mis en quarantaine. Garde les deux dans le même dossier et whiteliste-les.
  • L'UI web ne charge pas : vérifie dans la console le vrai api_port et que rien d'autre n'est bindé dessus ; essaie http://127.0.0.1:<port> explicitement.
  • Les peers ne se connectent pas (entrant) : autorise le port d'écoute dans le pare-feu Windows et, derrière un routeur, forwarde-le. En sortant seul, tu seedes quand même vers les peers qui peuvent t'atteindre.

Voir Dépannage pour le guide général.

Clone this wiki locally