Premenné prostredia

Expert

Všetky premenné, ktoré číta kontajner HolyArrs. Väčšina inštalácií nastavuje iba PUID, PGID a TZ.

Bežné

Premenná	Čo robí	Predvolene	Príklad
`PUID`, `PGID`	Používateľ a skupina, pod ktorými HolyArrs beží. Musia vlastniť `/config` a tvoje priečinky s médiami.	`1000`, `1000`	`PUID=1000`
`TZ`	Časové pásmo pre plány a logy.	`Etc/UTC`	`TZ=Europe/Amsterdam`
`UMASK`	Bity oprávnení, ktoré nové súbory nedostanú. Týka sa iba nových súborov.	`022`	`UMASK=002`
`HOLYARRS_SAVE_PATH`	Priečinok, kam ukladá sťahovač, tak ako ho vidí sťahovač. Posiela sa s každým sťahovaním.	žiadna	`/data/downloads`
`HOLYARRS_URL_BASE`	Sprístupní HolyArrs pod cestou za reverse proxy. `/` ignoruje cestu uloženú v nastaveniach.	žiadna	`/holyarrs`
`HOLYARRS_ALLOWED_HOSTS`	Ďalšie názvy hostiteľov, cez ktoré sa ľudia dostanú k HolyArrs, oddelené čiarkou.	IP adresy a `localhost`	`holyarrs.example.com`
`HOLYARRS_TRUSTED_PROXIES`	Adresa alebo sieť tvojho reverse proxy, oddelené čiarkou. Potrebné pre skutočné adresy klientov.	žiadna	`172.18.0.0/16`
`HOLYARRS_MASTER_KEY_FILE`	Načíta hlavný kľúč trezora z vlastného súboru. Používateľ `PUID` ho musí vedieť čítať.	`/config/holyarrs.key`	`/keys/holyarrs.key`

Hodnoty zo súborov

Pred ľubovoľnú premennú daj FILE__ a hodnota sa prečíta zo súboru, napríklad z Docker secret.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs odstráni jeden znak nového riadku na konci súboru. Ak súbor chýba, HolyArrs sa zastaví a log uvedie názov premennej a súboru, nikdy nie hodnotu.

Obnova a riešenie problémov

Premenná	Čo robí	Predvolene	Príklad
`HOLYARRS_SAFE_MODE`	Spustí iba jadro: prihlásenie, knižnicu, nastavenia, zálohy a kontrolu stavu. Po oprave ju odstráň.	vypnuté	`1`
`HOLYARRS_LOW_MEMORY`	`1` násilne zapne režim s nízkou pamäťou, `0` ho násilne vypne. Bez nastavenia sa zapne pri približne 2.5 GiB RAM alebo menej.	podľa veľkosti počítača	`1`
`HOLYARRS_FOLLOW_LINKS`	`1` dovolí skenovaniu knižnice a importom používať video a hudobné súbory, ktoré sú symlinky (knižnice postavené z odkazov na pripojený disk). Stiahnutý súbor sa do knižnice umiestni ako odkaz.	vypnuté	`1`
`GOMEMLIMIT`	Prepíše cieľ pamäte, ktorý si HolyArrs nastavuje sám.	nastaví HolyArrs	`1GiB`
`HOLYARRS_SKIP_SPACE_CHECK`	Preskočí kontrolu voľného miesta pred aktualizáciou databázy.	vypnuté	`yes`
`HOLYARRS_CONFIG_IN_MEMORY`	Povolí `/config` v priečinku v pamäti. Pre testovacie počítače; po reštarte sa dáta stratia.	vypnuté	`yes`
`HOLYARRS_ALLOW_DESKTOP_FOLDER`	Spustí s `/config` v zdieľanom priečinku Docker Desktop na Macu, keď si overíš, že tam fungujú zámky súborov. HolyArrs varuje pri každom štarte.	vypnuté	`1`
`HOLYARRS_READONLY_DOWNLOADERS`	Sťahovače, ktoré HolyArrs nesmie nikdy meniť, podľa id alebo adresy, oddelené čiarkou.	žiadne	`3,http://qbit:8080`
`HOLYARRS_HEALTH_URL`	Adresa, ktorú volá kontrola stavu kontajnera.	`http://127.0.0.1:6262`	`http://127.0.0.1:6262/holyarrs`

Premenné typu zapnúť/vypnúť prijímajú 1, true, yes alebo on.

Single sign-on

Nastav ich pred spustením. Ak je HOLYARRS_OIDC_ENABLED prítomná vôbec, aj ako false, single sign-on spravuje prostredie a nastavenia ho iba ukazujú. Prepínače zapnúť/vypnúť tu prijímajú iba true alebo false; čokoľvek iné zastaví štart.

Premenná	Čo robí	Predvolene
`HOLYARRS_OIDC_ENABLED`	Zapne single sign-on.	`false`
`HOLYARRS_OIDC_ISSUER`	Presný HTTPS issuer poskytovateľa.	žiadna
`HOLYARRS_OIDC_CLIENT_ID`	Registrované id klienta.	žiadna
`HOLYARRS_OIDC_CLIENT_SECRET_FILE`	Súbor s tajomstvom klienta, najviac 4096 bajtov. Pri verejnom klientovi vynechaj.	žiadna
`HOLYARRS_OIDC_REDIRECT_URL`	Presný callback: tvoja adresa, prípadne URL base a potom `/api/v1/auth/oidc/callback`.	žiadna
`HOLYARRS_OIDC_ALLOW_JOIN`	Noví ľudia sa pripoja ako členovia, ktorí môžu iba žiadať.	`false`
`HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK`	Povolí poskytovateľa v tvojej súkromnej sieti.	`false`
`HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP`	Povolí obyčajné HTTP na tomto počítači, na testovanie.	`false`
`HOLYARRS_FORWARD_AUTH_ENABLED`	Zapne prihlasovanie cez dôveryhodný proxy.	`false`
`HOLYARRS_FORWARD_AUTH_ISSUER`	Stabilný HTTPS názov proxy.	žiadna
`HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS`	Adresy alebo rozsahy proxy, ktoré smú posielať hlavičky s identitou, oddelené čiarkou.	žiadna
`HOLYARRS_FORWARD_AUTH_ALLOW_JOIN`	Nové mená z proxy sa pripoja ako členovia, ktorí môžu iba žiadať.	`false`

Zlé nastavenie zabráni spusteniu HolyArrs. Kroky sú v Prihlásenie a heslá.

Pre expertov

Metadáta

Premenná	Čo robí	Predvolene
`HOLYARRS_METADATA_URL`	Adresa metadátového servera.	`https://api.holyarrs.com`
`HOLYARRS_TMDB_KEY`	Tvoj vlastný read access token pre TMDB. Ak je nastavený, čítanie z TMDB ide priamo do TMDB namiesto metadátového servera.	žiadna
`HOLYARRS_METADATA_SERVICE_TOKEN_FILE`	Súbor s prístupovými údajmi tejto inštalácie pre metadátový server, číta sa pri každom volaní. Bez nastavenia sú údaje v trezore.	žiadna

Čo ide aj s tvojím vlastným kľúčom TMDB stále cez metadátový server a každá ďalšia vonkajšia adresa je v Vonkajšie adresy.

Skratky pre prvý štart

Každá pri štarte pridá jednu položku. Používajú sa na ukážky a testy; sprievodca pri prvom spustení robí to isté.

Premenná	Pridá
`HOLYARRS_MOVIES`	Priečinok knižnice s filmami.
`HOLYARRS_QBITTORRENT_URL`	Sťahovač qBittorrent.
`HOLYARRS_SOURCE_URL`	Zdroj Torznab bez kľúča.

Premenné pre vývojárov a testy

Tieto namierijú HolyArrs na náhradné služby pre testy. Pri skutočnej inštalácii ich nenastavuj.

Premenná	Čo robí
`HOLYARRS_FLAGS`	Prepínače oddelené čiarkou pre funkcie, ktoré sú v tejto verzii predvolene vypnuté. Pozri Aktualizácie.
`HOLYARRS_DIRECT_SOURCES`	`1` dovolí tejto inštalácii pýtať sa hudobných a TV zdrojov sama namiesto metadátového servera.
`HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL`	Povolí metadátový server v lokálnej sieti.
`HOLYARRS_METADATA_COUNT`	Počíta a loguje požiadavky na metadáta.
`HOLYARRS_TMDB_TOKEN_FILE`, `HOLYARRS_TMDB_URL`	Súbor s testovacím tokenom TMDB a náhradná 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`	Náhradné adresy pre externé služby.
`HOLYARRS_TRAILER_PASS_FIRST`, `HOLYARRS_TRAILER_PASS_EVERY`	Časovanie prechodu s trailermi ako trvania, napríklad `2s`.

Súvisiace stránky

HolyArrs je zadarmo. Ak ti ušetril čas, daj mu hviezdičku na GitHube, podpor ho alebo kúp mi kávu.