Модули и безбедни режим

Искључи модуле које не користиш, покрени у безбедном режиму када нешто не ради и рестартуј HolyArrs из претраживача.

Укључи или искључи модул

HolyArrs има 5 модула: Movies (филмови), TV shows (серије), Music (музика), Subtitles (титлови) и Requests (захтеви). Прво их бираш у чаробњаку при првом покретању.

1. Отвори Settings > Parts (подешавања > модули).
2. Кликни на Turn on (укључи) или Turn off (искључи) поред модула. Требало би да видиш како се ставке његовог менија појављују или нестају.

Ништа се не брише. Поново укључи модул и наставља тамо где је стао.

Покрени у безбедном режиму

Безбедни режим покреће само основне ствари, за случај када нешто спречава HolyArrs да се покрене или ради. Можеш да се пријавиш, погледаш библиотеку, промениш подешавања и направиш или вратиш бекап. Претрага, додавање, освежавање, преузимање и увоз чекају следеће нормално покретање.

1. Отвори Settings > Danger zone (подешавања > опасна зона).
2. Кликни на Restart in safe mode (рестартуј у безбедном режиму). Требало би да видиш банер на свакој страници.
3. Реши проблем, па кликни на Restart HolyArrs (рестартуј HolyArrs). Следеће покретање је нормално.

Ако не можеш да дођеш до странице, постави HOLYARRS_SAFE_MODE=1 у Compose-у или покрени са -safe-mode. Уклони то после поправке: обоје држе свако покретање у безбедном режиму.

Опције

Шта стаје када је модул искључен

Модул	Стаје	Наставља
Филмови	Странице и ставке менија за филмове, додавање, претрага, освежавање	Преузимања која су већ у твом преузимачу и даље се прате. Фајлови остају.
Серије	Странице серија, додавање, претрага, претраге по сезонама, освежавања	Исто као Филмови.
Музика	Странице извођача и албума, подешавања музике, освежавања извођача, претраге албума	Исто као Филмови.
Титлови	Подешавања титлова, страница недостајућих титлова, претраге и провере	Фајлови титлова поред твојих видеа остају.
Захтеви	Странице захтева и тражење наслова	Постојећи захтеви остају и враћају се када се модул поново укључи.

Увек укључено: пријава и налози, фолдери библиотеке, извори, преузимачи и преузимања, обавештења, историја, бекапи, провере исправности, подешавања и API.

• Титлови траже Филмове или Серије. Захтеви траже Филмове, Серије или Музику. HolyArrs одбија промену која ово ломи и каже шта прво да промениш.
• Задатак у реду за модул који је искључен чека и извршава се када се модул укључи.
• Искључивање модула не штеди меморију. Све ради у једном програму.

Рестарт, пауза и гашење

Settings > Danger zone (власник и админи) има Restart HolyArrs, Restart in safe mode и Shut down (угаси), плус Pause (пауза), Resume (настави) и Restart (рестарт) за сваки позадински задатак, као што су бекапи или синхронизација преузимања.

• Контроле које нешто зауставе траже да потврдиш у року од 60 s.
• Свака коришћена контрола уписује се у History (историја) са твојим именом.
• Потребна је пријава лозинком. Пријава без лозинке на твојој локалној мрежи се одбија.

Рестарт чисто зауставља HolyArrs и пушта Docker да га поново покрене, зато постави restart: unless-stopped.

Политика поновног покретања	Рестарт	Гашење
unless-stopped или always	Враћа се	Враћа се такође
on-failure	Враћа се	Остаје угашен
no	Остаје угашен	Остаје угашен

Ако не ради

Симптом	Узрок	Решење
HolyArrs не може да искључи модул	Други модул га захтева	Прво искључи тај модул, како порука каже.
Рестарт је заувек угасио HolyArrs	Политика поновног покретања је no	Покрени контејнер и постави restart: unless-stopped.
Контроле су одбијене	Локална пријава без лозинке, или кључ нема control	Пријави се својом лозинком.
Задатак остаје у стању failed	Потребан си ти	Прочитај његов разлог на /health, поправи, кликни на Restart за тај задатак.

Још решења: Решавање проблема.

За напредне

Стања исправности

/health, Settings > Parts и GET /api/v1/health/states наводе сваки позадински задатак, модул и повезану апликацију са стањем и разлогом.

Стање	Значење
off	Искључен, паузиран, или није покренут у безбедном режиму.
starting	Покреће се, или још није проверен.
running	Ради.
retrying	Није успело; HolyArrs покушава поново, чекајући сваки пут дуже.
failed	Пао, заглављен или треба тебе. Разлог каже шта да урадиш.

Задатак који падне показује failed, затим retrying, па се поново покрене. Пријава, библиотека и бекапи у међувремену раде. Заглављен задатак се чисти потпуним рестартом.

Меморија и режим мале потрошње меморије

HolyArrs циља да остане испод 384 MiB, што стаје у ограничење контејнера од 500 MB. Да поставиш свој циљ, постави GOMEMLIMIT на око 80 процената меморије контејнера.

Режим мале потрошње меморије држи мање у меморији и више чита из базе података. Неким страницама треба тренутак дуже, а позадински посао као копирање музичког каталога ради ређе.

Подешавање	Ефекат
(подразумевано, Linux)	Укључује се само од себе на око 2,5 GiB меморије или мање.
HOLYARRS_LOW_MEMORY=1	Увек укључено.
HOLYARRS_LOW_MEMORY=0	Увек искључено.

Прва линија лога каже да ли је укључен и зашто.

Опсези API кључева

Направи кључ у Settings > API > API keys и пошаљи га у заглављу X-Api-Key.

Опсег	Досеже
read	Библиотека, задаци, преузимања, историја, исправност, подешавања. Тајне су маскиране.
health_read	Само стања исправности. За алате за праћење.
write	Свака промена осим admin рута и контрола.
admin	Људи, позивнице, ограничења захтева, API кључеви, лозинка и двофакторска пријава, подешавања пријаве, бекапи.
control	Контроле са ове странице. Могу га дати само власник и админи.
all	read, write и admin. Не control.

Кључ никад не може више од особе која га је направила. Опсези се не могу касније мењати; направи нов кључ. Свака рута и њен опсег: /api/v1/openapi.json.

Повезане странице

• Провере исправности
• Бекапи
• API руте