Proměnné prostředí

Všechny proměnné, které čte kontejner HolyArrs. Většina instalací nastavuje jen PUID, PGID a TZ.

Běžné

Proměnná	Co dělá	Výchozí	Příklad
PUID, PGID	Uživatel a skupina, pod kterými HolyArrs běží. Musí vlastnit /config a tvoje složky s médii.	1000, 1000	PUID=1000
TZ	Časové pásmo pro plány a logy.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	Bity oprávnění, které nové soubory nedostanou. Týká se jen nových souborů.	022	UMASK=002
HOLYARRS_SAVE_PATH	Složka, kam stahovač ukládá, tak jak ji vidí stahovač. Posílá se s každým stahováním.	žádná	/data/downloads
HOLYARRS_URL_BASE	Provozuje HolyArrs pod cestou za reverzní proxy. / ignoruje cestu uloženou v Nastavení.	žádná	/holyarrs
HOLYARRS_ALLOWED_HOSTS	Další názvy hostitele, kterými lidé HolyArrs otevírají, oddělené čárkou.	IP adresy a localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	Adresa nebo síť tvé reverzní proxy, oddělené čárkou. Potřebné pro skutečné adresy klientů.	žádná	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	Načte hlavní klíč trezoru z vlastního souboru. Uživatel PUID ho musí umět přečíst.	/config/holyarrs.key	/keys/holyarrs.key

Hodnoty ze souborů

Dej FILE__ před libovolnou proměnnou a její hodnota se načte ze souboru, například z Docker secretu.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs odstraní jeden nový řádek na konci souboru. Když soubor chybí, HolyArrs se zastaví a log uvede název proměnné a souboru, nikdy hodnotu.

Obnova a řešení potíží

Proměnná	Co dělá	Výchozí	Příklad
HOLYARRS_SAFE_MODE	Spustí jen jádro: přihlášení, Knihovnu, nastavení, zálohy a zdraví. Po opravě ji odeber.	vypnuto	1
HOLYARRS_LOW_MEMORY	1 vynutí režim s nízkou pamětí, 0 ho vynutí vypnutý. Když není nastavena, zapne se přibližně při 2.5 GiB RAM nebo méně.	podle velikosti počítače	1
HOLYARRS_FOLLOW_LINKS	1 dovolí prohledávání Knihovny a importům používat video a hudební soubory, které jsou symlinky (knihovny postavené z odkazů na připojený disk). Stažený soubor s odkazem se do Knihovny umístí jako odkaz.	vypnuto	1
GOMEMLIMIT	Přepíše cíl paměti, který si HolyArrs sám nastavuje.	nastavuje HolyArrs	1GiB
HOLYARRS_SKIP_SPACE_CHECK	Přeskočí kontrolu volného místa před aktualizací databáze.	vypnuto	yes
HOLYARRS_CONFIG_IN_MEMORY	Dovolí /config ve složce v paměti. Pro testovací stroje; data se při restartu ztratí.	vypnuto	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Spustí se s /config ve sdílené složce Docker Desktopu na Macu, až ověříš, že tam fungují zámky souborů. HolyArrs varuje při každém spuštění.	vypnuto	1
HOLYARRS_READONLY_DOWNLOADERS	Stahovače, které HolyArrs nikdy nesmí měnit, podle id nebo adresy, oddělené čárkou.	žádné	3,http://qbit:8080
HOLYARRS_HEALTH_URL	Adresa, kterou volá kontrola zdraví kontejneru.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

Proměnné typu zapnuto/vypnuto přijímají 1, true, yes nebo on.

Single sign-on

Nastav je před spuštěním. Když je HOLYARRS_OIDC_ENABLED přítomná vůbec, i jako false, single sign-on spravuje prostředí a Nastavení ho jen zobrazuje. Přepínače zapnuto/vypnuto tady berou jen true nebo false; cokoli jiného zastaví start.

Proměnná	Co dělá	Výchozí
HOLYARRS_OIDC_ENABLED	Zapne single sign-on.	false
HOLYARRS_OIDC_ISSUER	Přesný HTTPS issuer poskytovatele.	žádný
HOLYARRS_OIDC_CLIENT_ID	Registrované id klienta.	žádné
HOLYARRS_OIDC_CLIENT_SECRET_FILE	Soubor s tajemstvím klienta, nejvýše 4096 bajtů. U veřejného klienta ho vynech.	žádný
HOLYARRS_OIDC_REDIRECT_URL	Přesný callback: tvoje adresa, případně URL base, pak /api/v1/auth/oidc/callback.	žádná
HOLYARRS_OIDC_ALLOW_JOIN	Noví lidé se přidají jako členové, kteří mohou jen žádat.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	Dovolí poskytovatele v tvé soukromé síti.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	Dovolí prosté HTTP na tomto počítači, pro testování.	false
HOLYARRS_FORWARD_AUTH_ENABLED	Zapne přihlášení přes důvěryhodnou proxy.	false
HOLYARRS_FORWARD_AUTH_ISSUER	Stabilní HTTPS název proxy.	žádný
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	Adresy nebo rozsahy proxy, které smějí posílat hlavičky s identitou, oddělené čárkou.	žádné
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	Nová jména z proxy se přidají jako členové, kteří mohou jen žádat.	false

Špatné nastavení HolyArrs nepustí ke startu. Postup je v Přihlášení a hesla.

Pro pokročilé

Metadata

Proměnná	Co dělá	Výchozí
HOLYARRS_METADATA_URL	Adresa serveru s metadaty.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	Tvůj vlastní čtecí token TMDB. Když je nastaven, čtení z TMDB jde přímo na TMDB místo na server s metadaty.	žádný
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	Soubor s přihlašovacím údajem této instalace k serveru s metadaty, čte se při každém volání. Když není nastaven, údaj je v trezoru.	žádný

Co s tvým vlastním klíčem TMDB stále jde přes server s metadaty a každá další vnější adresa je v Vnější adresy.

Zkratky pro první start

Každá při startu přidá jednu položku. Používají se pro ukázky a testy; průvodce prvním spuštěním dělá totéž.

Proměnná	Přidá
HOLYARRS_MOVIES	Složku Knihovny pro filmy.
HOLYARRS_QBITTORRENT_URL	Stahovač qBittorrent.
HOLYARRS_SOURCE_URL	Zdroj Torznab bez klíče.

Proměnné pro vývojáře a testy

Tyhle namíří HolyArrs na zástupné služby pro testy. Na skutečné instalaci je nech nenastavené.

Proměnná	Co dělá
HOLYARRS_FLAGS	Přepínače oddělené čárkou pro funkce, které jsou v této verzi ve výchozím stavu vypnuté. Viz Aktualizace.
HOLYARRS_DIRECT_SOURCES	1 dovolí této instalaci ptát se hudebních a TV zdrojů sama místo serveru s metadaty.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	Dovolí server s metadaty v místní síti.
HOLYARRS_METADATA_COUNT	Počítá a loguje požadavky na metadata.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	Soubor s testovacím tokenem TMDB a zástupná adresa.
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	Zástupné adresy pro vnější služby.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	Časování průchodu pro trailery jako doby, například 2s.

Související

• Instalace
• Provoz pod cestou
• Přihlášení a hesla