Části a nouzový režim

Vypni části, které nepoužíváš, při problémech spusť nouzový režim a restartuj HolyArrs z prohlížeče.

Zapni nebo vypni část

HolyArrs má 5 částí: Movies (filmy), TV shows (seriály), Music (hudba), Subtitles (titulky) a Requests (žádosti). Poprvé je vybíráš v průvodci prvním spuštěním.

1. Otevři Settings > Parts (Nastavení > Části).
2. Klikni vedle části na Turn on (zapnout) nebo Turn off (vypnout). Položky jejího menu by se měly objevit, nebo zmizet.

Nic se nemaže. Když část zase zapneš, naváže tam, kde skončila.

Spusť nouzový režim

Nouzový režim spustí jen základ, pro případ, že něco brání HolyArrs ve startu nebo fungování. Můžeš se přihlásit, prohlížet knihovnu, měnit nastavení a vytvářet nebo obnovovat zálohy. Hledání, přidávání, obnovování, stahování a import počkají do dalšího normálního startu.

1. Otevři Settings > Danger zone (Nastavení > Nebezpečná zóna).
2. Klikni na Restart in safe mode (restartovat v nouzovém režimu). Na každé stránce by se měl objevit banner.
3. Oprav problém a pak klikni na Restart HolyArrs (restartovat HolyArrs). Další start je normální.

Když se na stránku nedostaneš, nastav v Compose HOLYARRS_SAFE_MODE=1 nebo spusť s -safe-mode. Po opravě to odstraň: obojí drží každý start v nouzovém režimu.

Možnosti

Co se zastaví, když je část vypnutá

Část	Zastaví se	Pokračuje
Filmy	Stránky filmů a položky menu, přidávání, hledání, obnovování	Stahování, která už jsou ve stahovači, se dál sledují. Soubory zůstanou.
Seriály	Stránky seriálů, přidávání, hledání, hledání řad, obnovování	Stejně jako u filmů.
Hudba	Stránky umělců a alb, nastavení hudby, obnovování umělců, hledání alb	Stejně jako u filmů.
Titulky	Nastavení titulků, stránka chybějících titulků, hledání a kontroly	Soubory s titulky vedle tvých videí zůstanou.
Žádosti	Stránky žádostí a žádání o tituly	Existující žádosti zůstanou a vrátí se, až bude část zase zapnutá.

Vždy zapnuté: přihlášení a účty, složky knihovny, zdroje, stahovače a stahování, upozornění, historie, zálohy, kontroly zdraví, nastavení a API.

• Titulky potřebují filmy nebo seriály. Žádosti potřebují filmy, seriály nebo hudbu. HolyArrs odmítne změnu, která by to porušila, a řekne, co změnit nejdřív.
• Úloha ve frontě pro vypnutou část počká a spustí se, až bude část zapnutá.
• Vypnutí části nešetří paměť. Všechno běží v jednom programu.

Restart, pozastavení a vypnutí

Settings > Danger zone (vlastník a správci) obsahuje Restart HolyArrs, Restart in safe mode a Shut down (vypnout), a dále Pause (pozastavit), Resume (pokračovat) a Restart pro každou úlohu na pozadí, například zálohy nebo synchronizaci stahování.

• Ovládací prvky, které něco zastavují, chtějí potvrzení do 60 s.
• Každý použitý ovládací prvek se zapíše do historie s tvým jménem.
• Potřebuješ přihlášení heslem. Přihlášení bez hesla v místní síti se odmítne.

Restart HolyArrs čistě zastaví a nechá Docker, aby ho znovu spustil. Proto nastav restart: unless-stopped.

Zásada restartu	Restart	Vypnutí
unless-stopped nebo always	Znovu se spustí	Taky se znovu spustí
on-failure	Znovu se spustí	Zůstane vypnutý
no	Zůstane vypnutý	Zůstane vypnutý

Když to nefunguje

Příznak	Příčina	Řešení
HolyArrs nemůže vypnout část	Jiná část ji potřebuje	Vypni nejdřív tu část, jak říká zpráva.
Restart HolyArrs vypnul natrvalo	Zásada restartu je no	Spusť kontejner a nastav restart: unless-stopped.
Ovládací prvky jsou odmítnuty	Místní přihlášení bez hesla, nebo klíč nemá control	Přihlas se heslem.
Úloha zůstává ve stavu failed	Potřebuje tebe	Přečti si důvod na /health, oprav to a klikni u té úlohy na Restart.

Další řešení: Řešení potíží.

Pro pokročilé

Stavy zdraví

/health, Settings > Parts a GET /api/v1/health/states vypisují každou úlohu na pozadí, část a propojenou aplikaci se stavem a důvodem.

Stav	Význam
off	Vypnuto, pozastaveno, nebo nespuštěno v nouzovém režimu.
starting	Spouští se, nebo ještě nebylo zkontrolováno.
running	Funguje.
retrying	Selhalo; HolyArrs to zkouší znovu a pokaždé čeká déle.
failed	Spadlo, zaseklo se, nebo potřebuje tebe. Důvod říká, co dělat.

Spadlá úloha ukáže failed, pak retrying a pak se spustí znovu. Přihlášení, knihovna a zálohy mezitím fungují dál. Zaseknutá úloha se uvolní plným restartem.

Paměť a režim s nízkou pamětí

HolyArrs se snaží zůstat pod 384 MiB, což se vejde do limitu kontejneru 500 MB. Když chceš nastavit vlastní cíl, nastav GOMEMLIMIT na zhruba 80 procent paměti kontejneru.

Režim s nízkou pamětí drží v paměti méně a víc čte z databáze. Některé stránky se načtou o chvilku déle a práce na pozadí, například kopírování katalogu hudby, běží méně často.

Nastavení	Účinek
(výchozí, Linux)	Zapne se samo asi při 2.5 GiB paměti nebo méně.
HOLYARRS_LOW_MEMORY=1	Vždy zapnuto.
HOLYARRS_LOW_MEMORY=0	Vždy vypnuto.

První řádek logu říká, jestli je zapnutý a proč.

Rozsahy API klíčů

Vytvoř klíč v Settings > API > API keys a posílej ho v hlavičce X-Api-Key.

Rozsah	Dosáhne na
read	Knihovnu, úlohy, stahování, historii, zdraví, nastavení. Tajné údaje jsou zakryté.
health_read	Jen stavy zdraví. Pro monitorovací nástroje.
write	Každou změnu kromě admin rout a ovládacích prvků.
admin	Lidi, pozvánky, limity žádostí, API klíče, heslo a dvoufázové ověření, nastavení přihlášení, zálohy.
control	Ovládací prvky na této stránce. Udělit ho může jen vlastník a správci.
all	read, write a admin. Ne control.

Klíč nikdy nesmí víc než ten, kdo ho vytvořil. Rozsahy se nedají později změnit; vytvoř nový klíč. Každá routa a její rozsah: /api/v1/openapi.json.

Související

• Kontroly zdraví
• Zálohy
• API routy