Variabili d'ambiente

Tutte le variabili che il container di HolyArrs legge. Nella maggior parte delle installazioni bastano PUID, PGID e TZ.

Comuni

Variabile	Cosa fa	Predefinito	Esempio
PUID, PGID	Utente e gruppo con cui gira HolyArrs. Devono essere proprietari di /config e delle tue cartelle multimediali.	1000, 1000	PUID=1000
TZ	Fuso orario per le pianificazioni e i log.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	Bit di permesso che i nuovi file non ricevono. Vale solo per i file nuovi.	022	UMASK=002
HOLYARRS_SAVE_PATH	La cartella di salvataggio del downloader, come la vede il downloader. Viene inviata con ogni download.	nessuno	/data/downloads
HOLYARRS_URL_BASE	Serve HolyArrs sotto un percorso dietro un reverse proxy. / ignora un percorso salvato in Impostazioni.	nessuno	/holyarrs
HOLYARRS_ALLOWED_HOSTS	Nomi host aggiuntivi che le persone usano per raggiungere HolyArrs, separati da virgole.	IP e localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	L’indirizzo o la rete del tuo reverse proxy, separati da virgole. Serve per vedere i veri indirizzi dei client.	nessuno	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	Legge la chiave principale del vault da un file a parte. L’utente PUID deve poterlo leggere.	/config/holyarrs.key	/keys/holyarrs.key

Valori da file

Metti FILE__ davanti a qualsiasi variabile per leggerne il valore da un file, per esempio un secret di Docker.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs toglie un a capo alla fine del file. Se il file manca, HolyArrs si ferma e il log indica il nome della variabile e del file, mai il valore.

Ripristino e risoluzione dei problemi

Variabile	Cosa fa	Predefinito	Esempio
HOLYARRS_SAFE_MODE	Avvia solo il nucleo: accesso, Libreria, impostazioni, backup e salute. Toglila dopo la correzione.	disattivata	1
HOLYARRS_LOW_MEMORY	1 forza la modalità a basso consumo di memoria, 0 la esclude. Se non è impostata, si attiva con circa 2.5 GiB di RAM o meno.	in base alla dimensione del computer	1
GOMEMLIMIT	Sostituisce il limite di memoria che HolyArrs si dà da solo.	impostato da HolyArrs	1GiB
HOLYARRS_SKIP_SPACE_CHECK	Salta il controllo dello spazio libero prima di un aggiornamento del database.	disattivata	yes
HOLYARRS_CONFIG_IN_MEMORY	Permette /config in una cartella in memoria. Per i computer di prova; i dati si perdono al riavvio.	disattivata	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Avvia con /config in una cartella condivisa di Docker Desktop su un Mac, dopo che hai verificato che lì i blocchi dei file funzionano. HolyArrs mostra un’avvertenza a ogni avvio.	disattivata	1
HOLYARRS_READONLY_DOWNLOADERS	I downloader che HolyArrs non deve mai modificare, per id o indirizzo, separati da virgole.	nessuno	3,http://qbit:8080
HOLYARRS_HEALTH_URL	L’indirizzo che il controllo di salute del container chiama.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

Le variabili attivo/disattivo accettano 1, true, yes oppure on.

Accesso singolo (SSO)

Impostale prima dell’avvio. Se HOLYARRS_OIDC_ENABLED è presente, anche solo come false, l’accesso singolo è gestito dall’ambiente e Impostazioni lo mostra soltanto. Quelle attivo/disattivo qui accettano solo true o false; qualsiasi altro valore blocca l’avvio.

Variabile	Cosa fa	Predefinito
HOLYARRS_OIDC_ENABLED	Attiva l’accesso singolo.	false
HOLYARRS_OIDC_ISSUER	L’issuer HTTPS esatto del provider.	nessuno
HOLYARRS_OIDC_CLIENT_ID	L’id del client registrato.	nessuno
HOLYARRS_OIDC_CLIENT_SECRET_FILE	File con il secret del client, al massimo 4096 byte. Omettilo per un client pubblico.	nessuno
HOLYARRS_OIDC_REDIRECT_URL	Il callback esatto: il tuo indirizzo, l’URL base se c’è, poi /api/v1/auth/oidc/callback.	nessuno
HOLYARRS_OIDC_ALLOW_JOIN	Le nuove persone entrano come Membri che possono solo richiedere.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	Permette un provider sulla tua rete privata.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	Permette HTTP semplice su questo computer, per i test.	false
HOLYARRS_FORWARD_AUTH_ENABLED	Attiva l’accesso tramite proxy fidato.	false
HOLYARRS_FORWARD_AUTH_ISSUER	Un nome HTTPS stabile per il proxy.	nessuno
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	Indirizzi o intervalli del proxy autorizzati a inviare gli header di identità, separati da virgole.	nessuno
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	I nuovi nomi del proxy entrano come Membri che possono solo richiedere.	false

Una configurazione sbagliata impedisce l’avvio di HolyArrs. I passaggi sono in Accesso e password.

Per esperti

Metadati

Variabile	Cosa fa	Predefinito
HOLYARRS_METADATA_URL	L’indirizzo del server dei metadati.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	Il tuo token di lettura di TMDB. Se è impostato, le letture di TMDB vanno direttamente a TMDB invece che al server dei metadati.	nessuno
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	File con le credenziali di questa installazione per il server dei metadati, letto a ogni chiamata. Se non è impostato, le credenziali stanno nel vault.	nessuno

Scorciatoie del primo avvio

Ognuna aggiunge un elemento all’avvio. Servono per demo e test; la procedura guidata del primo avvio fa la stessa cosa.

Variabile	Aggiunge
HOLYARRS_MOVIES	Una cartella della Libreria per i film.
HOLYARRS_QBITTORRENT_URL	Un downloader qBittorrent.
HOLYARRS_SOURCE_URL	Una Fonte Torznab senza chiave.

Variabili per sviluppo e test

Puntano HolyArrs a servizi sostitutivi per i test. Lasciale non impostate in un’installazione vera.

Variabile	Cosa fa
HOLYARRS_FLAGS	Interruttori separati da virgole per le funzioni che in questa versione sono disattivate per impostazione predefinita. Vedi Aggiornamenti.
HOLYARRS_DIRECT_SOURCES	1 permette a questa installazione di interrogare da sola le fonti di musica e serie invece del server dei metadati.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	Permette un server dei metadati sulla rete locale.
HOLYARRS_METADATA_COUNT	Conta e registra nel log le richieste di metadati.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	File del token TMDB di prova e indirizzo sostitutivo.
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	Indirizzi sostitutivi per i servizi esterni.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	Tempi del passaggio dei trailer come durate, per esempio 2s.

Correlati

• Installazione
• Eseguire sotto un percorso
• Accesso e password