Omgevingsvariabelen

Alle variabelen die de HolyArrs-container leest. De meeste installaties stellen alleen PUID, PGID en TZ in.

Veelgebruikt

Variabele	Wat het doet	Standaard	Voorbeeld
PUID, PGID	Gebruiker en groep waaronder HolyArrs draait. Moet eigenaar zijn van /config en je mediamappen.	1000, 1000	PUID=1000
TZ	Tijdzone voor schema’s en logs.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	Rechtenbits die nieuwe bestanden niet krijgen. Geldt alleen voor nieuwe bestanden.	022	UMASK=002
HOLYARRS_SAVE_PATH	De opslagmap van de downloader, zoals de downloader hem ziet. Wordt bij elke download meegestuurd.	geen	/data/downloads
HOLYARRS_URL_BASE	Laat HolyArrs onder een pad draaien achter een reverse proxy. / negeert een pad dat in de instellingen is opgeslagen.	geen	/holyarrs
HOLYARRS_ALLOWED_HOSTS	Extra hostnamen waarmee mensen HolyArrs bereiken, gescheiden door komma’s.	IP-adressen en localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	Het adres of netwerk van je reverse proxy, gescheiden door komma’s. Nodig voor de echte adressen van clients.	geen	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	Leest de hoofdsleutel van de kluis uit een eigen bestand. De PUID-gebruiker moet het kunnen lezen.	/config/holyarrs.key	/keys/holyarrs.key

Waarden uit bestanden

Zet FILE__ voor elke variabele om de waarde uit een bestand te lezen, bijvoorbeeld een Docker-secret.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs laat één regeleinde aan het eind van het bestand weg. Ontbreekt het bestand, dan stopt HolyArrs en noemt de log de variabele en het bestand, nooit de waarde.

Herstel en problemen oplossen

Variabele	Wat het doet	Standaard	Voorbeeld
HOLYARRS_SAFE_MODE	Start alleen de kern: aanmelden, bibliotheek, instellingen, backups en gezondheid. Haal de variabele weg na de oplossing.	uit	1
HOLYARRS_LOW_MEMORY	1 zet de modus voor weinig geheugen aan, 0 zet hem uit. Zonder waarde gaat hij aan bij ongeveer 2,5 GiB RAM of minder.	naar grootte van de computer	1
GOMEMLIMIT	Overschrijft het geheugendoel dat HolyArrs zichzelf stelt.	door HolyArrs ingesteld	1GiB
HOLYARRS_SKIP_SPACE_CHECK	Slaat de controle op vrije ruimte over vóór een database-update.	uit	yes
HOLYARRS_CONFIG_IN_MEMORY	Staat /config toe op een map in het geheugen. Voor testcomputers; data gaat verloren bij een herstart.	uit	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Start met /config in een gedeelde map van Docker Desktop op een Mac, nadat je hebt gecontroleerd dat bestandsvergrendeling daar werkt. HolyArrs waarschuwt bij elke start.	uit	1
HOLYARRS_READONLY_DOWNLOADERS	Downloaders die HolyArrs nooit mag wijzigen, op id of adres, gescheiden door komma’s.	geen	3,http://qbit:8080
HOLYARRS_HEALTH_URL	Adres dat de gezondheidscontrole van de container aanroept.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

Aan/uit-variabelen accepteren 1, true, yes of on.

Single sign-on

Stel deze in vóór de start. Als HOLYARRS_OIDC_ENABLED er is, zelfs als false, dan beheert de omgeving single sign-on en toont Instellingen het alleen. De aan/uit-variabelen hier accepteren alleen true of false; alles anders stopt de start.

Variabele	Wat het doet	Standaard
HOLYARRS_OIDC_ENABLED	Zet single sign-on aan.	false
HOLYARRS_OIDC_ISSUER	De exacte HTTPS-issuer van de provider.	geen
HOLYARRS_OIDC_CLIENT_ID	Geregistreerde client-id.	geen
HOLYARRS_OIDC_CLIENT_SECRET_FILE	Bestand met het client secret, maximaal 4096 bytes. Laat weg voor een publieke client.	geen
HOLYARRS_OIDC_REDIRECT_URL	Exacte callback: je adres, de URL base indien aanwezig, dan /api/v1/auth/oidc/callback.	geen
HOLYARRS_OIDC_ALLOW_JOIN	Nieuwe mensen worden leden die alleen kunnen aanvragen.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	Staat een provider op je privénetwerk toe.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	Staat gewone HTTP toe op deze computer, om te testen.	false
HOLYARRS_FORWARD_AUTH_ENABLED	Zet aanmelden via een vertrouwde proxy aan.	false
HOLYARRS_FORWARD_AUTH_ISSUER	Vaste HTTPS-naam voor de proxy.	geen
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	Proxyadressen of -bereiken die identiteitsheaders mogen sturen, gescheiden door komma’s.	geen
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	Nieuwe proxynamen worden leden die alleen kunnen aanvragen.	false

Een foute configuratie voorkomt dat HolyArrs start. De stappen staan in Aanmelden en wachtwoorden.

Voor gevorderden

Metadata

Variabele	Wat het doet	Standaard
HOLYARRS_METADATA_URL	Het adres van de metadataserver.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	Je eigen TMDB read access token. Als dit is ingesteld, gaan TMDB-aanvragen rechtstreeks naar TMDB in plaats van via de metadataserver.	geen
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	Bestand met de toegangsgegevens van deze installatie voor de metadataserver, bij elke aanroep opnieuw gelezen. Zonder waarde staan ze in de kluis.	geen

Snelkoppelingen bij de eerste start

Elke variabele voegt bij de start één item toe. Bedoeld voor demo’s en tests; de wizard bij de eerste start doet hetzelfde.

Variabele	Voegt toe
HOLYARRS_MOVIES	Een bibliotheekmap voor films.
HOLYARRS_QBITTORRENT_URL	Een qBittorrent-downloader.
HOLYARRS_SOURCE_URL	Een Torznab-bron zonder sleutel.

Variabelen voor ontwikkelaars en tests

Deze wijzen HolyArrs naar vervangers voor tests. Laat ze weg op een echte installatie.

Variabele	Wat het doet
HOLYARRS_FLAGS	Door komma’s gescheiden schakelaars voor functies die in deze versie standaard uit staan. Zie Updates.
HOLYARRS_DIRECT_SOURCES	Met 1 vraagt deze installatie muziek- en tv-bronnen zelf in plaats van via de metadataserver.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	Staat een metadataserver op het lokale netwerk toe.
HOLYARRS_METADATA_COUNT	Telt en logt metadata-aanvragen.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	Testbestand voor het TMDB-token en het adres van de vervanger.
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	Adressen van vervangers voor externe diensten.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	Timing van de trailerronde als duur, zoals 2s.

Gerelateerde pagina’s

• Installeren
• Onder een pad draaien
• Aanmelden en wachtwoorden