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

Изключи модулите, които не ползваш, стартирай в безопасен режим, когато нещо се счупи, и рестартирай 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.
• Всяка използвана контрола се записва в История с твоето име.
• Трябва ти вход с парола. Вход без парола в локалната мрежа се отказва.

Рестартът спира 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	Хора, покани, лимити на заявките, API ключове, парола и двуфакторно удостоверяване, настройки за вход, резервни копия.
control	Контролите на тази страница. Само собственикът и администраторите могат да го дадат.
all	read, write и admin. Не control.

Ключ никога не може повече от човека, който го е направил. Обхватите не могат да се променят по-късно; направи нов ключ. Всеки маршрут и обхватът му: /api/v1/openapi.json.

Свързано

• Проверки на здравето
• Резервни копия
• API маршрути