Dépannage

Trouvez votre symptôme, lisez la cause, suivez la solution. Les exemples utilisent le nom de conteneur holyarrs ; utilisez le vôtre s’il est différent.

Les 3 premières vérifications

1. Regardez le journal : docker logs -f holyarrs. Les secrets sont masqués. Appuyez sur Ctrl+C pour arrêter de le suivre ; le conteneur continue de tourner.
2. Lancez le diagnostic (doctor) : docker exec holyarrs /holyarrs doctor. Chaque ligne indique OK, WARN ou FAIL, et chaque WARN ou FAIL explique comment le corriger.
3. Toujours bloqué ? Téléchargez une archive de diagnostic et posez votre question. Voir Obtenir de l’aide.

La page web est inaccessible

Symptôme : le navigateur n’arrive pas à se connecter à http://your-server:6262.

Cause : le conteneur est arrêté, le port n’est pas mappé, ou un proxy bloque le passage.

Solution :

1. Lancez docker ps. Vous devriez voir holyarrs avec 0.0.0.0:6262->6262.
2. S’il redémarre sans arrêt, lisez docker logs holyarrs pour en connaître la raison.
3. Si vous utilisez un chemin comme /holyarrs, voir Reverse proxy et base d’URL.

Permission refusée

Symptôme : le diagnostic indique qu’un dossier n’est pas accessible en écriture, ou les imports échouent avec une erreur de permission.

Cause : le propriétaire du dossier sur l’hôte ne correspond pas à PUID et PGID.

Solution : lancez le chown que propose le diagnostic, ou donnez à PUID et PGID les valeurs du propriétaire du dossier. Sur un NAS, donnez à cet utilisateur l’accès en lecture et en écriture dans l’écran des permissions. Voir NAS, Synology et Unraid.

Rien ne se télécharge

Symptôme : les titres restent manquants et rien n’arrive dans votre client de téléchargement.

Cause : aucune source ne répond, le client de téléchargement n’est pas connecté, ou aucune release ne passe vos règles de sélection.

Solution :

1. Ouvrez Settings > Downloaders (Paramètres > Clients de téléchargement) et appuyez sur Test (tester) pour votre client de téléchargement. Le test devrait réussir.
2. Ouvrez Settings > Sources et appuyez sur Test pour chaque source.
3. Sur le titre, ouvrez Choose a release (choisir une release) pour voir tous les résultats et les raisons pour lesquelles ils n’ont pas été choisis.

Voir Clients de téléchargement et Sources.

Téléchargé mais pas importé

Symptôme : le téléchargement est terminé dans votre client de téléchargement, mais le titre n’est pas dans votre Bibliothèque.

Cause : HolyArrs ne voit pas le fichier au même chemin, ne peut pas écrire dans le dossier de bibliothèque, ou l’import attend une décision.

Solution :

1. Donnez à HolyArrs et au client de téléchargement le même dossier de téléchargement au même chemin, par exemple /downloads, ou renseignez Downloader’s path (chemin du client de téléchargement) et HolyArrs’ path (chemin de HolyArrs) sur le client de téléchargement.
2. Lancez le diagnostic et corrigez chaque FAIL sur les dossiers de téléchargement ou de bibliothèque.
3. Cherchez dans la liste des téléchargements les éléments marqués Needs a decision (Décision requise), puis approuvez ou abandonnez le plan.

Les imports sont des copies, pas des hardlinks

Symptôme : le diagnostic indique que les hardlinks (liens physiques) ne fonctionnent pas, ou l’espace disque utilisé double après les imports.

Cause : les téléchargements et les dossiers de bibliothèque sont sur des disques ou des montages différents.

Solution : montez un seul dossier parent commun dans le conteneur plutôt que des dossiers séparés. Voir Dossiers.

HolyArrs ne démarre pas

Symptôme : le conteneur s’arrête ou redémarre tout de suite.

Cause : le journal la donne. Les plus courantes : /config sur un partage réseau ou un chemin FUSE, ou un module en panne.

Solution :

1. Déplacez /config sur un disque local si le journal le demande. HolyArrs refuse de faire tourner sa base de données sur un partage.
2. Sinon, démarrez en mode sans échec, corrigez le problème depuis Settings, puis redémarrez normalement.

Une fonctionnalité manque

Symptôme : une fonctionnalité dont vous avez lu la description n’est pas dans l’application.

Cause : elle est peut-être en réserve dans cette version.

Solution : voir Fonctionnalités en réserve.

Les pages n’ont ni noms ni images

Symptôme : les titres s’affichent sans affiche ni détails.

Cause : le serveur de métadonnées est injoignable.

Solution : vérifiez votre DNS et votre pare-feu. La section Network (réseau) du diagnostic montre si le serveur répond.

Pour les experts

Contrôles et options du diagnostic

Le diagnostic tourne dans le conteneur, sous le même utilisateur que HolyArrs. Il rencontre donc les mêmes obstacles que HolyArrs.

Section	Affiche
App (application)	Version, utilisateur et groupe, umask, exécution dans un conteneur ou non.
Config folder (dossier de configuration)	Propriétaire, droits, espace libre, présence sur un disque local ou non.
Library and download folders (dossiers de bibliothèque et de téléchargement)	Existence, propriétaire, accès en écriture, espace libre, hardlinks entre les dossiers de téléchargement et de bibliothèque.
Network (réseau)	Si le nom du serveur de métadonnées se résout et si le serveur répond.
Clock (horloge)	Heure, fuseau horaire (TZ), un avertissement quand l’horloge est clairement fausse.

Option	Ce que ça fait
-config <folder>	Contrôle un autre dossier de configuration HolyArrs que /config.
-json	Affiche le rapport en JSON.

Le code de sortie 0 veut dire que rien n’a échoué ; 1 veut dire qu’une ligne indique FAIL. Le rapport ne montre jamais de clés, de mots de passe ni de jetons. Il ne fait que lire, sauf un petit fichier de test qu’il écrit puis supprime. Lancé en tant que root, il donne aussi le dossier de configuration à PUID:PGID, comme un démarrage normal.

Si HolyArrs redémarre sans arrêt, docker exec échoue. Lancez le diagnostic dans un nouveau conteneur avec les mêmes dossiers :

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Avec Compose : docker compose run --rm holyarrs doctor.

Contrôle des dossiers au démarrage

Au démarrage, HolyArrs contrôle ses dossiers et écrit dans le journal une ligne de résumé, par exemple folders: 4 ok, 1 not writable, puis une ligne par dossier en difficulté avec une solution. Le contrôle s’arrête au bout de 3 secondes pour que le démarrage ne reste jamais bloqué. Un dossier trop lent à répondre compte comme non contrôlé ; c’est souvent un disque qui sort de veille ou un partage réseau lent. Le diagnostic le contrôle sans limite de temps. Voir Journaux.

Pas de shell dans l'image

L’image ne contient que le programme HolyArrs. Elle reste donc petite et laisse moins de prise à un attaquant. docker exec holyarrs sh échoue, et c’est voulu. Pour regarder de plus près, démarrez à côté un conteneur d’appoint jetable :

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Il voit le processus HolyArrs, partage son réseau et a les mêmes dossiers aux mêmes chemins. Il tourne en tant que root, alors regardez sans rien modifier : un fichier écrit en tant que root peut être illisible pour HolyArrs. Pour tester sous l’utilisateur de HolyArrs, ajoutez --user <PUID>:<PGID>.

Trouver la version

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

La section App du diagnostic affiche la même chose.

Voir aussi

• Obtenir de l’aide
• Journaux
• Contrôles de santé