Променливи на средата

Експерт

Всички променливи, които контейнерът на HolyArrs чете. Повечето инсталации задават само PUID, PGID и TZ.

Често използвани

Променлива	Какво прави	По подразбиране	Пример
`PUID`, `PGID`	Потребителят и групата, с които работи HolyArrs. Трябва да са собственици на `/config` и на папките с медия.	`1000`, `1000`	`PUID=1000`
`TZ`	Часова зона за графиците и дневниците.	`Etc/UTC`	`TZ=Europe/Amsterdam`
`UMASK`	Битовете за права, които новите файлове не получават. Важи само за нови файлове.	`022`	`UMASK=002`
`HOLYARRS_SAVE_PATH`	Папката за запис на програмата за изтегляне, както я вижда самата програма. Изпраща се с всяко изтегляне.	няма	`/data/downloads`
`HOLYARRS_URL_BASE`	Показва HolyArrs под път зад reverse proxy. `/` игнорира пътя, запазен в Настройки.	няма	`/holyarrs`
`HOLYARRS_ALLOWED_HOSTS`	Допълнителни имена на host, през които хората достигат HolyArrs, разделени със запетая.	IP адресите и `localhost`	`holyarrs.example.com`
`HOLYARRS_TRUSTED_PROXIES`	Адресът или мрежата на твоя reverse proxy, разделени със запетая. Нужно е, за да се виждат истинските адреси на клиентите.	няма	`172.18.0.0/16`
`HOLYARRS_MASTER_KEY_FILE`	Чете главния ключ на трезора от отделен файл. Потребителят `PUID` трябва да може да го чете.	`/config/holyarrs.key`	`/keys/holyarrs.key`

Стойности от файлове

Сложи FILE__ пред коя да е променлива, за да четеш стойността ѝ от файл, например от Docker secret.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs маха един нов ред в края на файла. Ако файлът липсва, HolyArrs спира, а дневникът (log) назовава променливата и файла, но никога стойността.

Възстановяване и отстраняване на проблеми

Променлива	Какво прави	По подразбиране	Пример
`HOLYARRS_SAFE_MODE`	Стартира само ядрото: вход, Библиотека, настройки, резервни копия и здраве. Махни я след поправката.	изключено	`1`
`HOLYARRS_LOW_MEMORY`	`1` включва принудително режима за малко памет, `0` го изключва принудително. Ако не е зададена, режимът се включва при около 2.5 GiB RAM или по-малко.	според размера на компютъра	`1`
`HOLYARRS_FOLLOW_LINKS`	`1` позволява на сканирането на Библиотеката и на импортирането да ползват видео и музикални файлове, които са symlink (библиотеки, направени от връзки към монтиран диск). Изтегляне, което е symlink, се поставя в Библиотеката като връзка.	изключено	`1`
`GOMEMLIMIT`	Променя целта за памет, която HolyArrs задава сам на себе си.	задава се от HolyArrs	`1GiB`
`HOLYARRS_SKIP_SPACE_CHECK`	Пропуска проверката за свободно място преди актуализация на базата данни.	изключено	`yes`
`HOLYARRS_CONFIG_IN_MEMORY`	Позволява `/config` в папка, която стои в паметта. За тестови компютри; данните се губят при рестарт.	изключено	`yes`
`HOLYARRS_ALLOW_DESKTOP_FOLDER`	Стартира с `/config` в споделена папка на Docker Desktop на Mac, след като си проверил, че заключването на файлове работи там. HolyArrs предупреждава при всяко стартиране.	изключено	`1`
`HOLYARRS_READONLY_DOWNLOADERS`	Програми за изтегляне, които HolyArrs никога не бива да променя, по id или адрес, разделени със запетая.	няма	`3,http://qbit:8080`
`HOLYARRS_HEALTH_URL`	Адресът, който проверката на здравето на контейнера извиква.	`http://127.0.0.1:6262`	`http://127.0.0.1:6262/holyarrs`

Променливите за включване и изключване приемат 1, true, yes или on.

Единичен вход

Задай ги преди стартиране. Ако HOLYARRS_OIDC_ENABLED присъства изобщо, дори като false, средата държи единичния вход, а Настройки само го показват. Тези за включване и изключване тук приемат само true или false; всичко друго спира стартирането.

Променлива	Какво прави	По подразбиране
`HOLYARRS_OIDC_ENABLED`	Включва единичния вход.	`false`
`HOLYARRS_OIDC_ISSUER`	Точният HTTPS issuer на доставчика.	няма
`HOLYARRS_OIDC_CLIENT_ID`	Регистрираният id на клиента.	няма
`HOLYARRS_OIDC_CLIENT_SECRET_FILE`	Файл с тайната на клиента, най-много 4096 байта. Пропусни го за публичен клиент.	няма
`HOLYARRS_OIDC_REDIRECT_URL`	Точният callback: твоят адрес, URL base ако има, после `/api/v1/auth/oidc/callback`.	няма
`HOLYARRS_OIDC_ALLOW_JOIN`	Новите хора се присъединяват като членове, които могат само да заявяват.	`false`
`HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK`	Позволява доставчик в твоята частна мрежа.	`false`
`HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP`	Позволява обикновен HTTP на този компютър, за тестване.	`false`
`HOLYARRS_FORWARD_AUTH_ENABLED`	Включва вход през доверен proxy.	`false`
`HOLYARRS_FORWARD_AUTH_ISSUER`	Постоянно HTTPS име за proxy.	няма
`HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS`	Адреси или диапазони на proxy, на които е позволено да пращат заглавия с идентичност, разделени със запетая.	няма
`HOLYARRS_FORWARD_AUTH_ALLOW_JOIN`	Новите имена от proxy се присъединяват като членове, които могат само да заявяват.	`false`

Грешна настройка пречи на HolyArrs да стартира. Стъпките са в Вход и пароли.

За експерти

Метаданни

Променлива	Какво прави	По подразбиране
`HOLYARRS_METADATA_URL`	Адресът на сървъра за метаданни.	`https://api.holyarrs.com`
`HOLYARRS_TMDB_KEY`	Твоят собствен read access token за TMDB. Когато е зададен, четенията от TMDB отиват направо към TMDB, а не през сървъра за метаданни.	няма
`HOLYARRS_METADATA_SERVICE_TOKEN_FILE`	Файл с данните за достъп на тази инсталация до сървъра за метаданни, чете се при всяко извикване. Ако не е зададен, данните стоят в трезора.	няма

Какво още минава през сървъра за метаданни при твой собствен TMDB ключ и всеки друг външен адрес е в Външни адреси.

Бързи настройки при първо стартиране

Всяка добавя по един елемент при стартиране. Ползват се за демонстрации и тестове; съветникът при първо стартиране прави същото.

Променлива	Добавя
`HOLYARRS_MOVIES`	Папка на Библиотеката за филми.
`HOLYARRS_QBITTORRENT_URL`	Програма за изтегляне qBittorrent.
`HOLYARRS_SOURCE_URL`	Източник Torznab без ключ.

Променливи за разработчици и тестове

Те насочват HolyArrs към заместващи услуги за тестове. Остави ги незададени при истинска инсталация.

Променлива	Какво прави
`HOLYARRS_FLAGS`	Превключватели, разделени със запетая, за функции, които са изключени по подразбиране в тази версия. Виж Актуализации.
`HOLYARRS_DIRECT_SOURCES`	`1` позволява тази инсталация да пита сама източниците за музика и сериали, вместо сървъра за метаданни.
`HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL`	Позволява сървър за метаданни в локалната мрежа.
`HOLYARRS_METADATA_COUNT`	Брои и записва в дневника извикванията към метаданните.
`HOLYARRS_TMDB_TOKEN_FILE`, `HOLYARRS_TMDB_URL`	Тестов файл с TMDB token и заместващ адрес.
`HOLYARRS_TVMAZE_URL`, `HOLYARRS_MUSICBRAINZ_URL`, `HOLYARRS_DEEZER_URL`, `HOLYARRS_TRAKT_URL`, `HOLYARRS_PLEX_URL`, `HOLYARRS_PLEX_APP_URL`, `HOLYARRS_PLEX_DISCOVER_URL`, `HOLYARRS_PUSHOVER_URL`, `HOLYARRS_TELEGRAM_URL`, `HOLYARRS_YOUTUBE_URL`, `HOLYARRS_RELEASE_FEED`	Заместващи адреси за външни услуги.
`HOLYARRS_TRAILER_PASS_FIRST`, `HOLYARRS_TRAILER_PASS_EVERY`	Времена за обхода на трейлъри като продължителности, например `2s`.

Свързано

HolyArrs е безплатен. Ако ти е спестил време, сложи му звезда в GitHub, подкрепи го или почерпи ме с кафе.