Troubleshooting FR

🇬🇧 English · 🇫🇷 Français

Dépannage

Les pièges qu'on rencontre vraiment.

Les identifiants se régénèrent à chaque redémarrage

Cause : le volume de config n'est pas monté sur /config (au singulier). L'image lit/écrit config, resume et store durable sous /config ; si tu montes ton dossier ailleurs, chaque boot repart d'une config vide et régénère le mot de passe admin et la clé API. Fix : monte ton dossier hôte sur /config exactement. Récupère le mot de passe admin dans docker logs après le premier boot (correct).

L'import qBit / un qBittorrent LAN est injoignable (derrière un VPN)

Cause : quand Hydra tourne dans un conteneur VPN (gluetun), son egress sort par le tunnel, donc il ne peut pas joindre un qBittorrent sur ton LAN (ex. l'assistant d'import). Fix : autorise le sous-réseau LAN en sortie de gluetun — sur le service gluetun mets FIREWALL_OUTBOUND_SUBNETS=192.168.x.0/24 (nom exact, pluriel, avec le masque), puis up -d. Et rappelle-toi que localhost est le netns du VPN, pas ton hôte — utilise l'IP LAN.

Recheck / verify renvoie une erreur sur un torrent race

Par design. Verify/recheck est hoard uniquement — le moteur race n'a pas de piece picker pour enregistrer la vérification par pièce. Recheck les torrents que tu comptes seeder. Voir Ajouter des torrents & données existantes.

Le recheck rapporte 0/N sur des données que je suis sûr d'avoir

Presque toujours un décalage de save-path — le fichier est un niveau de dossier trop loin. Les single-file lisent save_path/<nom> ; les multi-file lisent save_path/<nom>/<fichiers…>. Aligne le save-path sur l'emplacement réel.

Le recheck qBit avec hashes=all ne fait rien

Volontaire. Un recheck de masse sur un hoard de 100k torrents serait une tempête disque, donc all est ignoré. Passe des info-hashes explicites.

Impossible de seeder sur les deux moteurs derrière un seul port VPN

Un port forwardé sert un moteur (deux moteurs = deux process, pas de partage d'un port TCP inbound). Fais tourner un moteur par gluetun avec un contrôleur front-only — voir Topologies de déploiement et Gluetun (VPN).

L'UI est brièvement injoignable juste après un redémarrage

L'API monte après le chargement des moteurs. Sur un gros hoard ce rechargement prend un peu (resume + import du store durable), donc laisse-lui une minute après un restart avant que l'UI réponde. C'est normal et ça ne re-hash pas tes données.

Le premier login web échoue / « auth not configured »

Le bloc [auth] n'a pas encore de password_hash. Sur une install neuve Hydra en génère un et affiche le clair une fois dans les logs ; récupère-le là. Pour poser le tien : docker run --rm --entrypoint hydra <image> hash-password '<mdp>' et colle le hash dans [auth] password_hash.