Časti a núdzový režim

Vypni časti, ktoré nepoužívaš, spusti núdzový režim, keď sa niečo pokazí, a reštartuj HolyArrs z prehliadača.

Zapni alebo vypni časť

HolyArrs má 5 častí: Movies (filmy), TV shows (seriály), Music (hudba), Subtitles (titulky) a Requests (žiadosti). Najprv ich vyberáš v sprievodcovi prvého spustenia.

1. Otvor Settings > Parts (nastavenia > časti).
2. Klikni na Turn on (zapnúť) alebo Turn off (vypnúť) vedľa časti. Jej položky v menu by sa mali objaviť alebo zmiznúť.

Nič sa nemaže. Zapni časť znova a pokračuje tam, kde skončila.

Spusti v núdzovom režime

Núdzový režim spustí iba základ, pre prípad, že niečo bráni HolyArrs v spustení alebo fungovaní. Môžeš sa prihlásiť, pozrieť si knižnicu, meniť nastavenia a vytvoriť alebo obnoviť zálohu. Hľadanie, pridávanie, obnovovanie, sťahovanie a importovanie počkajú na ďalšie bežné spustenie.

1. Otvor Settings > Danger zone (nastavenia > nebezpečná zóna).
2. Klikni na Restart in safe mode (reštartovať v núdzovom režime). Na každej stránke by si mal vidieť banner.
3. Oprav problém a potom klikni na Restart HolyArrs (reštartovať HolyArrs). Ďalšie spustenie je bežné.

Ak sa na stránku nevieš dostať, nastav v Compose HOLYARRS_SAFE_MODE=1 alebo spusti s -safe-mode. Po oprave to odstráň: obe možnosti udržia každé spustenie v núdzovom režime.

Možnosti

Čo sa zastaví, keď je časť vypnutá

Časť	Zastaví sa	Pokračuje
Filmy	Stránky filmov a položky menu, pridávanie, hľadanie, obnovovanie	Sťahovania, ktoré už sú v tvojom sťahovači, sa naďalej sledujú. Súbory zostanú.
Seriály	Stránky seriálov, pridávanie, hľadanie, hľadanie sérií, obnovovanie	To isté ako pri filmoch.
Hudba	Stránky interpretov a albumov, nastavenia hudby, obnovovanie interpretov, hľadanie albumov	To isté ako pri filmoch.
Titulky	Nastavenia titulkov, stránka chýbajúcich titulkov, hľadanie a kontroly	Súbory titulkov vedľa tvojich videí zostanú.
Žiadosti	Stránky žiadostí a žiadanie o tituly	Existujúce žiadosti zostanú a vrátia sa, keď sa časť znova zapne.

Vždy zapnuté: prihlásenie a účty, priečinky knižnice, zdroje, sťahovače a sťahovania, upozornenia, história, zálohy, kontroly stavu, nastavenia a API.

• Titulky potrebujú filmy alebo seriály. Žiadosti potrebujú filmy, seriály alebo hudbu. HolyArrs zamietne zmenu, ktorá by to porušila, a povie, čo treba zmeniť najprv.
• Úloha vo fronte pre vypnutú časť čaká a spustí sa, keď sa časť zapne.
• Vypnutie časti neušetrí pamäť. Všetko beží v jednom programe.

Reštart, pozastavenie a vypnutie

Settings > Danger zone (vlastník a admini) obsahuje Restart HolyArrs, Restart in safe mode a Shut down (vypnúť), plus Pause (pozastaviť), Resume (pokračovať) a Restart pre každú úlohu na pozadí, napríklad zálohy alebo synchronizáciu sťahovaní.

• Ovládacie prvky, ktoré niečo zastavia, žiadajú potvrdenie do 60 s.
• Každý použitý ovládací prvok sa zapíše do histórie s tvojím menom.
• Potrebuješ prihlásenie heslom. Prihlásenie bez hesla v lokálnej sieti sa zamietne.

Reštart čisto zastaví HolyArrs a Docker ho potom spustí znova, preto nastav restart: unless-stopped.

Politika reštartu	Reštart	Vypnutie
unless-stopped alebo always	Vráti sa	Vráti sa tiež
on-failure	Vráti sa	Zostane vypnutý
no	Zostane vypnutý	Zostane vypnutý

Ak to nefunguje

Príznak	Príčina	Riešenie
HolyArrs nevie vypnúť časť	Iná časť ju potrebuje	Vypni najprv tú časť, ako hovorí správa.
Reštart HolyArrs vypol natrvalo	Politika reštartu je no	Spusti kontajner a nastav restart: unless-stopped.
Ovládacie prvky sa zamietajú	Lokálne prihlásenie bez hesla, alebo kľúč nemá control	Prihlás sa heslom.
Úloha zostáva v stave zlyhala	Potrebuje teba	Prečítaj si jej dôvod na /health, oprav ho a klikni na Restart pri tej úlohe.

Ďalšie riešenia: Riešenie problémov.

Pre expertov

Stavy zdravia

/health, Settings > Parts a GET /api/v1/health/states vypisujú každú úlohu na pozadí, časť a prepojenú aplikáciu so stavom a dôvodom.

Stav	Význam
off	Vypnuté, pozastavené alebo nespustené v núdzovom režime.
starting	Spúšťa sa alebo ešte nebolo skontrolované.
running	Funguje.
retrying	Zlyhalo; HolyArrs to skúša znova a vždy čaká dlhšie.
failed	Zhavarovalo, uviazlo alebo potrebuje teba. Dôvod hovorí, čo robiť.

Úloha, ktorá zhavaruje, ukáže failed, potom retrying a znova sa spustí. Prihlásenie, knižnica a zálohy medzitým fungujú ďalej. Uviaznutá úloha sa vyčistí úplným reštartom.

Pamäť a režim s nízkou pamäťou

HolyArrs sa snaží zostať pod 384 MiB, čo sa zmestí do limitu kontajnera 500 MB. Ak chceš vlastný cieľ, nastav GOMEMLIMIT na približne 80 percent pamäte kontajnera.

Režim s nízkou pamäťou drží v pamäti menej a viac číta z databázy. Niektoré stránky sa načítajú o chvíľu dlhšie a práca na pozadí, napríklad kopírovanie hudobného katalógu, beží zriedkavejšie.

Nastavenie	Účinok
(predvolene, Linux)	Zapne sa samo pri približne 2.5 GiB pamäte alebo menej.
HOLYARRS_LOW_MEMORY=1	Vždy zapnutý.
HOLYARRS_LOW_MEMORY=0	Vždy vypnutý.

Prvý riadok logu povie, či je zapnutý a prečo.

Rozsahy kľúčov API

Vytvor kľúč v Settings > API > API keys a posielaj ho v hlavičke X-Api-Key.

Rozsah	Dosiahne
read	Knižnica, úlohy, sťahovania, história, zdravie, nastavenia. Tajomstvá zamaskované.
health_read	Iba stavy zdravia. Pre monitorovacie nástroje.
write	Každá zmena okrem admin trás a ovládacích prvkov.
admin	Ľudia, pozvánky, limity žiadostí, kľúče API, heslo a dvojfaktorové overenie, nastavenia prihlásenia, zálohy.
control	Ovládacie prvky na tejto stránke. Udeliť ho môže iba vlastník a admini.
all	read, write a admin. Nie control.

Kľúč nikdy nedokáže viac než človek, ktorý ho vytvoril. Rozsahy sa neskôr nedajú zmeniť; vytvor nový kľúč. Každá trasa a jej rozsah: /api/v1/openapi.json.

Súvisiace stránky

• Kontroly stavu
• Zálohy
• Trasy API