Installation and First Run FR

🇬🇧 English · 🇫🇷 Français

Installation & premier démarrage

Docker Compose (recommandé)

Une image prête est publiée sur GHCR : ghcr.io/kheopsian/hydra. Épingle une version (:v3.4.0) en production ; :latest suit main.

services:
  hydra:
    image: ghcr.io/kheopsian/hydra:latest
    container_name: hydra
    restart: unless-stopped
    ports:
      - "8199:8199"        # UI web / API
      - "16171:16171"      # port d'écoute race (à forwarder sur ta box)
      - "16172:16172"      # port d'écoute hoard
    volumes:
      - ./config:/config   # config, resume, store durable
      - /path/to/data:/data

La convention de volume est /config (au singulier). L'image lit et écrit sa config, ses resume et son store durable sous /config. Monter ton dossier ailleurs = le conteneur régénère le mot de passe admin et la clé API à chaque redémarrage. Voir Dépannage.

Premier démarrage

Au premier lancement, sans identifiants configurés, Hydra :

1. génère une clé API aléatoire et l'écrit dans default.toml,
2. génère un mot de passe admin aléatoire, le hache en bcrypt dans [auth] et affiche le clair une fois dans les logs (niveau WARN, username=admin password=…).

Récupère ce mot de passe dans docker logs hydra, puis connecte-toi sur http://<host>:8199 en admin. Tu peux le changer ensuite depuis l'UI (Config → Account). Les deux sont idempotents : un reboot avec le hash déjà en place ne régénère rien.

Si tu préfères poser le mot de passe toi-même :

docker run --rm --entrypoint hydra ghcr.io/kheopsian/hydra:latest hash-password 'tonmotdepasse'
# colle le hash bcrypt affiché dans [auth] password_hash de ./config/default.toml

Ajouter ton premier torrent

Utilise le bouton Add Torrent de l'UI, ou pointe un outil d'automatisation sur le shim qBittorrent. Si les données existent déjà sur disque, lis d'abord Ajouter des torrents & données existantes — ça décide si Hydra fait confiance aux données ou les vérifie.

Build depuis les sources

Nécessite Rust (2021+) et Go 1.25. Le Dockerfile multi-stage build les deux et c'est le chemin recommandé ; voir le README pour les commandes cargo/go build manuelles.