Problemen oplossen

Zoek je symptoom, lees de oorzaak en volg de oplossing. De voorbeelden gebruiken de containernaam holyarrs; gebruik de jouwe als die anders is.

Eerste 3 controles

1. Bekijk de log: docker logs -f holyarrs. Geheimen zijn gemaskeerd. Druk op Ctrl+C om te stoppen met volgen; de container blijft draaien.
2. Voer de doctor uit: docker exec holyarrs /holyarrs doctor. Elke regel zegt OK, WARN of FAIL, en bij elke WARN of FAIL staat hoe je het oplost.
3. Kom je er nog niet uit? Download een ondersteuningspakket en vraag om hulp. Zie Hulp krijgen.

De webpagina is niet te bereiken

Symptoom: de browser kan geen verbinding maken met http://your-server:6262.

Oorzaak: de container is gestopt, de poort is niet toegewezen of er zit een proxy in de weg.

Oplossing:

1. Voer docker ps uit. Je ziet holyarrs met 0.0.0.0:6262->6262.
2. Herstart de container steeds? Lees dan docker logs holyarrs voor de reden.
3. Gebruik je een pad zoals /holyarrs? Zie Reverse proxy en URL base.

Toegang geweigerd

Symptoom: de doctor meldt dat een map niet beschrijfbaar is, of imports mislukken met een rechtenfout.

Oorzaak: de eigenaar van de map op de host komt niet overeen met PUID en PGID.

Oplossing: voer de chown uit die de doctor voorstelt, of zet PUID en PGID op de eigenaar van de map. Geef op een NAS die gebruiker lees- en schrijfrechten in het rechtenscherm. Zie NAS, Synology en Unraid.

Er wordt niets gedownload

Symptoom: titels blijven ontbreken en er komt niets bij je downloader aan.

Oorzaak: geen enkele bron antwoordt, de downloader is niet verbonden of geen release door je keuzeregels komt.

Oplossing:

1. Open Settings > Downloaders (instellingen > downloaders) en klik op Test (testen) bij je downloader. Die moet slagen.
2. Open Settings > Sources (instellingen > bronnen) en klik op Test bij elke bron.
3. Open bij de titel Choose a release (release kiezen) om elk resultaat te zien en de redenen waarom het niet is gekozen.

Zie Downloaders en Bronnen.

Gedownload maar niet geïmporteerd

Symptoom: de download is klaar in je downloader, maar de titel staat niet in je bibliotheek.

Oorzaak: HolyArrs ziet het bestand niet op hetzelfde pad, kan niet naar de bibliotheekmap schrijven, of de import heeft een beslissing nodig.

Oplossing:

1. Geef HolyArrs en de downloader dezelfde downloadmap op hetzelfde pad, zoals /downloads, of stel Downloader’s path (pad van de downloader) en HolyArrs’ path (pad van HolyArrs) in bij de downloader.
2. Voer de doctor uit en los elke FAIL bij de download- of bibliotheekmappen op.
3. Zoek in de downloadlijst items met Needs a decision (beslissing nodig) en keur het plan goed of gooi het weg.

Imports zijn kopieën, geen hardlinks

Symptoom: de doctor meldt dat hardlinks niet werken, of het schijfgebruik verdubbelt na imports.

Oorzaak: de download- en bibliotheekmappen staan op verschillende schijven of mounts.

Oplossing: mount één gedeelde bovenliggende map in de container in plaats van aparte mappen. Zie Mappen.

HolyArrs start niet

Symptoom: de container stopt of herstart meteen.

Oorzaak: de log noemt hem. Veelvoorkomend: /config op een netwerkshare of FUSE-pad, of een kapot onderdeel.

Oplossing:

1. Verplaats /config naar een lokale schijf als de log dat zegt. HolyArrs draait zijn database niet op een share.
2. Anders start je in de veilige modus, los je het op via Settings (instellingen) en herstart je normaal.

Een functie ontbreekt

Symptoom: een functie waarover je las staat niet in de app.

Oorzaak: hij kan in deze versie zijn uitgesteld.

Oplossing: zie Uitgestelde functies.

Pagina’s hebben geen namen of afbeeldingen

Symptoom: titels verschijnen zonder posters of details.

Oorzaak: de metadataserver is niet bereikbaar.

Oplossing: controleer je DNS en firewall. In het gedeelte Network van de doctor zie je of de server antwoordt.

Voor gevorderden

Controles en opties van de doctor

De doctor draait in de container als dezelfde gebruiker als HolyArrs, dus hij loopt tegen hetzelfde aan als HolyArrs.

Gedeelte	Toont
App	Versie, gebruiker en groep, umask, of hij in een container draait.
Configuratiemap	Eigenaar, rechten, vrije ruimte, of hij op een lokale schijf staat.
Bibliotheek- en downloadmappen	Bestaat, eigenaar, beschrijfbaar, vrije ruimte, hardlinks tussen download- en bibliotheekmappen.
Netwerk	Of de naam van de metadataserver wordt omgezet en hij antwoordt.
Klok	Tijd, tijdzone (TZ), een waarschuwing als de klok duidelijk fout staat.

Optie	Wat hij doet
-config <folder>	Controleert een andere configuratiemap van HolyArrs dan /config.
-json	Geeft het rapport als JSON.

Exitcode 0 betekent dat niets faalde; 1 betekent dat een regel FAIL zegt. Het rapport toont nooit sleutels, wachtwoorden of tokens. Het leest alleen, behalve een klein testbestand dat het schrijft en weer verwijdert. Start je als root, dan geeft hij de configuratiemap ook aan PUID:PGID, net als een normale start.

Herstart HolyArrs steeds, dan mislukt docker exec. Voer de doctor uit in een nieuwe container met dezelfde mappen:

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

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

Mappencontrole bij het starten

Bij het starten controleert HolyArrs zijn mappen en logt één samenvattingsregel, zoals folders: 4 ok, 1 not writable, en daarna één regel per probleemmap met een oplossing. De controle stopt na 3 seconden, zodat het starten nooit blijft hangen. Een map die te traag antwoordt telt als niet gecontroleerd; vaak is dat een schijf die wakker wordt uit slaap of een trage netwerkshare. De doctor controleert zonder tijdslimiet. Zie Logs.

Geen shell in de image

De image bevat alleen het HolyArrs-programma, zodat hij klein blijft en een aanvaller minder vindt. docker exec holyarrs sh mislukt met opzet. Wil je beter kijken, start dan een wegwerp-helpercontainer ernaast:

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

Die ziet het HolyArrs-proces, deelt het netwerk en heeft dezelfde mappen op dezelfde paden. Hij draait als root, dus kijk alleen en wijzig niets: een bestand dat als root is geschreven, kan onleesbaar zijn voor HolyArrs. Wil je testen als de HolyArrs-gebruiker, voeg dan --user <PUID>:<PGID> toe.

De versie vinden

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

Het gedeelte App van de doctor toont hetzelfde.

Gerelateerde pagina’s

• Hulp krijgen
• Logs
• Gezondheidscontroles