Riešenie problémov

Nájdi svoj príznak, prečítaj si príčinu a postupuj podľa riešenia. Príklady používajú názov kontajnera holyarrs; ak máš iný, použi svoj.

Prvé 3 kontroly

1. Sleduj log: docker logs -f holyarrs. Tajné údaje sú zamaskované. Sledovanie ukončíš cez Ctrl+C; kontajner beží ďalej.
2. Spusti doctor: docker exec holyarrs /holyarrs doctor. Každý riadok hovorí OK, WARN alebo FAIL a ku každému WARN alebo FAIL je napísané, ako to opraviť.
3. Stále si zaseknutý? Stiahni balík pre podporu a opýtaj sa. Pozri Získať podporu.

Webová stránka sa neotvorí

Príznak: prehliadač sa nevie pripojiť na http://your-server:6262.

Príčina: kontajner je zastavený, port nie je namapovaný alebo v ceste stojí proxy.

Riešenie:

1. Spusti docker ps. Mal by si vidieť holyarrs s 0.0.0.0:6262->6262.
2. Ak sa stále reštartuje, dôvod nájdeš v docker logs holyarrs.
3. Ak používaš cestu, napríklad /holyarrs, pozri Reverse proxy a URL base.

Prístup zamietnutý

Príznak: doctor hlási, že do priečinka sa nedá zapisovať, alebo importy zlyhávajú s chybou oprávnenia.

Príčina: vlastník priečinka na hostiteľovi nesedí s PUID a PGID.

Riešenie: spusti chown, ktorý doctor navrhne, alebo nastav PUID a PGID na vlastníka priečinka. Na NAS daj tomuto používateľovi čítanie a zápis na obrazovke s oprávneniami. Pozri NAS, Synology a Unraid.

Nič sa nesťahuje

Príznak: tituly zostávajú chýbajúce a nič sa nedostane do tvojho sťahovača.

Príčina: žiadny zdroj neodpovedá, sťahovač nie je pripojený alebo žiadny release nespĺňa tvoje pravidlá výberu.

Riešenie:

1. Otvor Settings > Downloaders (Nastavenia > Sťahovače) a klikni na Test (otestovať) pri svojom sťahovači. Mal by prejsť.
2. Otvor Settings > Sources (Nastavenia > Zdroje) a klikni na Test pri každom zdroji.
3. Na tituli otvor Choose a release (vybrať release), aby si videl všetky výsledky a dôvody, prečo sa nevybral.

Pozri Sťahovače a Zdroje.

Stiahnuté, ale neimportované

Príznak: sťahovanie sa v sťahovači dokončilo, ale titul nie je v tvojej knižnici.

Príčina: HolyArrs nevidí súbor na rovnakej ceste, nemôže zapisovať do priečinka knižnice alebo import čaká na rozhodnutie.

Riešenie:

1. Daj HolyArrs aj sťahovaču ten istý priečinok na sťahovanie na rovnakej ceste, napríklad /downloads, alebo nastav Downloader’s path (cesta sťahovača) a HolyArrs’ path (cesta HolyArrs) na sťahovači.
2. Spusti doctor a oprav každý FAIL pri priečinkoch na sťahovanie alebo priečinkoch knižnice.
3. V zozname sťahovaní skontroluj položky označené Needs a decision (čaká na rozhodnutie) a schváľ alebo zahoď ich plán.

Importy sú kópie, nie hardlinky

Príznak: doctor hlási, že hardlinky nefungujú, alebo sa po importoch zdvojnásobí využitie disku.

Príčina: priečinky na sťahovanie a priečinky knižnice sú na rôznych diskoch alebo pripojeniach, alebo disk nevie robiť hardlinky (DrivePool, mnohé NAS a zdieľania SMB, Docker Desktop na Windows). Každý súbor sa aj tak zapíše len raz. Dokončené sťahovania z Usenetu sa presunú, keď sú na rovnakom disku ako knižnica.

Riešenie: do kontajnera pripoj jeden spoločný nadradený priečinok namiesto samostatných. Pozri Priečinky.

HolyArrs sa nespustí

Príznak: kontajner sa zastaví alebo sa okamžite reštartuje.

Príčina: uvádza ju log. Časté sú: /config na sieťovom zdieľaní alebo ceste FUSE, alebo pokazená časť.

Riešenie:

1. Ak to hovorí log, presuň /config na lokálny disk. HolyArrs nespustí svoju databázu na zdieľaní.
2. Inak spusti v núdzovom režime, oprav to v Settings (Nastavenia) a reštartuj normálne.

Funkcia chýba

Príznak: funkcia, o ktorej si čítal, v aplikácii nie je.

Príčina: v tejto verzii môže byť pozdržaná.

Riešenie: pozri Pozdržané funkcie.

Stránky nemajú názvy ani obrázky

Príznak: tituly sa zobrazujú bez plagátov a podrobností.

Príčina: metadátový server je nedostupný.

Riešenie: skontroluj svoj DNS a firewall. Sekcia Network v doctorovi ukáže, či server odpovedá.

Pre expertov

Kontroly a voľby doctora

Doctor beží vnútri kontajnera pod rovnakým používateľom ako HolyArrs, takže narazí na to isté, na čo narazí HolyArrs.

Sekcia	Ukazuje
App	Verziu, používateľa a skupinu, umask, či beží v kontajneri.
Config folder	Vlastníka, oprávnenia, voľné miesto, či je na lokálnom disku.
Library and download folders	Či existuje, vlastníka, či sa dá zapisovať, voľné miesto, hardlinky medzi priečinkami na sťahovanie a priečinkami knižnice.
Network	Či sa názov metadátového servera preloží a či server odpovedá.
Clock	Čas, časové pásmo (TZ), varovanie, keď sú hodiny jasne zlé.

Voľba	Čo robí
-config <folder>	Skontroluje iný konfiguračný priečinok HolyArrs než /config.
-json	Vypíše report ako JSON.

Návratový kód 0 znamená, že nič nezlyhalo; 1 znamená, že niektorý riadok hovorí FAIL. Report nikdy neukáže kľúče, heslá ani tokeny. Iba číta, okrem malého testovacieho súboru, ktorý zapíše a odstráni. Ak je spustený ako root, odovzdá aj konfiguračný priečinok používateľovi PUID:PGID, rovnako ako pri normálnom štarte.

Ak sa HolyArrs stále reštartuje, docker exec zlyhá. Spusti doctor v novom kontajneri s rovnakými priečinkami:

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

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

Kontrola priečinkov pri štarte

Pri štarte HolyArrs skontroluje svoje priečinky a zapíše do logu jeden súhrnný riadok, napríklad folders: 4 ok, 1 not writable, potom jeden riadok na každý problémový priečinok s riešením. Kontrola sa po 3 sekundách zastaví, aby sa štart nikdy nezasekol. Priečinok, ktorý odpovedá príliš pomaly, sa počíta ako neskontrolovaný; často ide o disk, ktorý sa budí zo spánku, alebo pomalé sieťové zdieľanie. Doctor ho kontroluje bez časového limitu. Pozri Logy.

V image nie je shell

Image obsahuje iba program HolyArrs, takže zostáva malý a útočník v ňom nemá čo nájsť. docker exec holyarrs sh zlyhá zámerne. Na bližší pohľad spusti vedľa neho jednorazového pomocníka:

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

Vidí proces HolyArrs, zdieľa jeho sieť a má rovnaké priečinky na rovnakých cestách. Beží ako root, takže iba pozeraj a nemeň: súbor zapísaný ako root nemusí byť pre HolyArrs čitateľný. Ak chceš testovať ako používateľ HolyArrs, pridaj --user <PUID>:<PGID>.

Zisti verziu

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

To isté ukáže sekcia App v doctorovi.

Súvisiace stránky

• Získať podporu
• Logy
• Kontroly stavu