Řešení potíží

Najdi svůj příznak, přečti si příčinu a postupuj podle řešení. Příklady používají název kontejneru holyarrs; pokud se tvůj liší, použij svůj.

První 3 kontroly

1. Sleduj log: docker logs -f holyarrs. Tajné údaje jsou zamaskované. Sledování ukončíš klávesami Ctrl+C; kontejner dál běží.
2. Spusť doctor: docker exec holyarrs /holyarrs doctor. Každý řádek říká OK, WARN nebo FAIL a u každého WARN nebo FAIL je napsáno, jak ho opravit.
3. Pořád to nejde? Stáhni si balíček pro podporu a požádej o pomoc. Viz Získat podporu.

Webová stránka se neotevře

Příznak: prohlížeč se nemůže připojit na http://your-server:6262.

Příčina: kontejner je zastavený, port není namapovaný, nebo v cestě stojí proxy.

Řešení:

1. Spusť docker ps. Měl bys vidět holyarrs s 0.0.0.0:6262->6262.
2. Pokud se pořád restartuje, přečti si důvod v docker logs holyarrs.
3. Pokud používáš cestu jako /holyarrs, viz Reverzní proxy a URL base.

Přístup odepřen

Příznak: doctor hlásí, že do složky nejde zapisovat, nebo importy selhávají s chybou oprávnění.

Příčina: vlastník složky na hostiteli nesouhlasí s PUID a PGID.

Řešení: spusť příkaz chown, který doctor navrhuje, nebo nastav PUID a PGID podle vlastníka složky. Na NAS dej tomuto uživateli na obrazovce oprávnění čtení i zápis. Viz NAS, Synology a Unraid.

Nic se nestahuje

Příznak: tituly zůstávají chybějící a do tvého stahovače nic nedorazí.

Příčina: žádný zdroj neodpovídá, stahovač není připojený, nebo žádný release nesplňuje tvoje pravidla výběru.

Řešení:

1. Otevři Settings > Downloaders (Nastavení > Stahovače) a u svého stahovače klikni na Test. Měl by projít.
2. Otevři Settings > Sources (Nastavení > Zdroje) a u každého zdroje klikni na Test.
3. U titulu otevři Choose a release (vybrat release), uvidíš všechny výsledky a důvody, proč nebyly vybrány.

Viz Stahovače a Zdroje.

Staženo, ale neimportováno

Příznak: stahování ve tvém stahovači skončilo, ale titul není v Knihovně.

Příčina: HolyArrs nevidí soubor na stejné cestě, nemůže zapisovat do složky knihovny, nebo import čeká na rozhodnutí.

Řešení:

1. Dej HolyArrs i stahovači stejnou složku pro stahování na stejné cestě, například /downloads, nebo ve stahovači nastav Downloader’s path (cesta stahovače) a HolyArrs’ path (cesta HolyArrs).
2. Spusť doctor a oprav každé FAIL u složek pro stahování nebo Knihovny.
3. V seznamu stahování najdi položky označené Needs a decision (čeká na rozhodnutí) a schval nebo zahoď jejich plán.

Importy jsou kopie, ne hardlinky

Příznak: doctor hlásí, že hardlinky nefungují, nebo se po importech zdvojnásobí využití disku.

Příčina: složky pro stahování a Knihovnu jsou na různých discích nebo připojeních, nebo disk hardlinky neumí (DrivePool, mnoho NAS a sdílených složek SMB, Docker Desktop na Windows). Každý soubor se přesto zapíše jen jednou. Dokončená usenetová stahování se přesunou, když sdílejí disk s Knihovnou.

Řešení: připoj do kontejneru jednu sdílenou nadřazenou složku místo oddělených. Viz Složky.

HolyArrs se nespustí

Příznak: kontejner se zastaví nebo se okamžitě restartuje.

Příčina: uvádí ji log. Časté jsou: /config na sdílené složce v síti nebo na cestě FUSE, nebo rozbitá část.

Řešení:

1. Pokud to log říká, přesuň /config na místní disk. HolyArrs svou databázi na sdílené složce provozovat nebude.
2. Jinak spusť nouzový režim, oprav to v Settings (Nastavení) a pak spusť normálně znovu.

Chybí nějaká funkce

Příznak: funkce, o které jsi četl, v aplikaci není.

Příčina: v tomto vydání může být odložená.

Řešení: viz Odložené funkce.

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

Příznak: tituly se zobrazují bez plakátů a podrobností.

Příčina: metadata server není dostupný.

Řešení: zkontroluj DNS a firewall. Sekce Network v doctoru ukáže, jestli server odpovídá.

Pro pokročilé

Kontroly a volby příkazu doctor

Doctor běží uvnitř kontejneru pod stejným uživatelem jako HolyArrs, takže narazí na totéž co HolyArrs.

Sekce	Ukazuje
App	Verzi, uživatele a skupinu, umask, jestli běží v kontejneru.
Config folder	Vlastníka, oprávnění, volné místo, jestli je na místním disku.
Library and download folders	Jestli existují, vlastníka, zapisovatelnost, volné místo, hardlinky mezi složkami pro stahování a Knihovny.
Network	Jestli se název metadata serveru přeloží a jestli server odpovídá.
Clock	Čas, časové pásmo (TZ), varování, když jsou hodiny zjevně špatně.

Volba	Co dělá
-config <folder>	Zkontroluje jinou konfigurační složku HolyArrs než /config.
-json	Vypíše zprávu jako JSON.

Návratový kód 0 znamená, že nic neselhalo; 1 znamená, že nějaký řádek hlásí FAIL. Zpráva nikdy neukazuje klíče, hesla ani tokeny. Jen čte, kromě malého testovacího souboru, který zapíše a zase smaže. Když je spuštěný jako root, předá navíc konfigurační složku uživateli PUID:PGID, stejně jako při běžném startu.

Když se HolyArrs pořád restartuje, docker exec selže. Spusť doctor v novém kontejneru se stejnými složkami:

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 složek při startu

Při startu HolyArrs zkontroluje své složky a zapíše jeden souhrnný řádek, například folders: 4 ok, 1 not writable, a pak jeden řádek pro každou problémovou složku s řešením. Kontrola se po 3 sekundách zastaví, aby start nikdy nezůstal viset. Složka, která odpovídá příliš pomalu, se počítá jako nezkontrolovaná; často je to disk probouzející se ze spánku nebo pomalá sdílená složka v síti. Doctor ji kontroluje bez časového limitu. Viz Logy.

V image není shell

Image obsahuje jen program HolyArrs, takže zůstává malý a útočník má méně možností. docker exec holyarrs sh záměrně selže. Chceš-li se podívat blíž, spusť vedle něj jednorázového pomocníka:

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

Vidí proces HolyArrs, sdílí jeho síť a má stejné složky na stejných cestách. Běží jako root, takže se jen dívej a neměň: soubor zapsaný jako root nemusí HolyArrs umět přečíst. Chceš-li testovat jako uživatel HolyArrs, přidej --user <PUID>:<PGID>.

Zjisti verzi

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

Totéž ukazuje sekce App v doctoru.

Související

• Získat podporu
• Logy
• Kontroly zdraví