Zmienne środowiskowe

Wszystkie zmienne, które czyta kontener HolyArrs. Przy większości instalacji ustawiasz tylko PUID, PGID i TZ.

Najczęstsze

Zmienna	Co robi	Domyślnie	Przykład
PUID, PGID	Użytkownik i grupa, z którymi działa HolyArrs. Muszą być właścicielami /config i twoich folderów z multimediami.	1000, 1000	PUID=1000
TZ	Strefa czasowa dla harmonogramów i logów.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	Bity uprawnień, których nowe pliki nie dostają. Dotyczy tylko nowych plików.	022	UMASK=002
HOLYARRS_SAVE_PATH	Folder zapisu downloadera, tak jak widzi go downloader. Wysyłany z każdym pobieraniem.	brak	/data/downloads
HOLYARRS_URL_BASE	Udostępnia HolyArrs pod ścieżką za reverse proxy. / ignoruje ścieżkę zapisaną w ustawieniach.	brak	/holyarrs
HOLYARRS_ALLOWED_HOSTS	Dodatkowe nazwy hosta, którymi ludzie łączą się z HolyArrs, oddzielone przecinkami.	adresy IP i localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	Adres lub sieć twojego reverse proxy, oddzielone przecinkami. Potrzebne, żeby widzieć prawdziwe adresy klientów.	brak	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	Czyta klucz główny sejfu z osobnego pliku. Użytkownik PUID musi móc go odczytać.	/config/holyarrs.key	/keys/holyarrs.key

Wartości z plików

Dopisz FILE__ przed dowolną zmienną, żeby wczytać jej wartość z pliku, na przykład z sekretu Dockera.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs odcina jeden znak nowej linii na końcu pliku. Jeśli pliku brakuje, HolyArrs się zatrzymuje, a log podaje nazwę zmiennej i pliku, nigdy wartość.

Odzyskiwanie i rozwiązywanie problemów

Zmienna	Co robi	Domyślnie	Przykład
HOLYARRS_SAFE_MODE	Uruchamia tylko rdzeń: logowanie, bibliotekę, ustawienia, backupy i kondycję. Usuń ją po naprawie.	wyłączona	1
HOLYARRS_LOW_MEMORY	1 wymusza tryb niskiego zużycia pamięci, 0 go wyłącza. Bez ustawienia włącza się przy około 2.5 GiB pamięci RAM lub mniej.	zależy od komputera	1
GOMEMLIMIT	Zmienia limit pamięci, który HolyArrs sam sobie ustawia.	ustawia HolyArrs	1GiB
HOLYARRS_SKIP_SPACE_CHECK	Pomija kontrolę wolnego miejsca przed aktualizacją bazy danych.	wyłączona	yes
HOLYARRS_CONFIG_IN_MEMORY	Pozwala trzymać /config w folderze w pamięci. Dla komputerów testowych; dane znikają po restarcie.	wyłączona	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Uruchamia z /config we współdzielonym folderze Docker Desktop na Macu, jeśli sprawdzisz, że blokady plików tam działają. HolyArrs ostrzega przy każdym starcie.	wyłączona	1
HOLYARRS_READONLY_DOWNLOADERS	Downloadery, których HolyArrs nigdy nie może zmieniać, podane przez id lub adres, oddzielone przecinkami.	brak	3,http://qbit:8080
HOLYARRS_HEALTH_URL	Adres, który wywołuje kontrola kondycji kontenera.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

Zmienne włącz/wyłącz przyjmują 1, true, yes lub on.

Single sign-on (SSO)

Ustaw je przed uruchomieniem. Jeśli HOLYARRS_OIDC_ENABLED w ogóle jest obecna, nawet jako false, to środowisko zarządza single sign-on, a Ustawienia tylko je pokazują. Zmienne włącz/wyłącz w tej tabeli przyjmują tylko true lub false; cokolwiek innego zatrzymuje start.

Zmienna	Co robi	Domyślnie
HOLYARRS_OIDC_ENABLED	Włącza single sign-on.	false
HOLYARRS_OIDC_ISSUER	Dokładny issuer HTTPS dostawcy.	brak
HOLYARRS_OIDC_CLIENT_ID	Zarejestrowane id klienta.	brak
HOLYARRS_OIDC_CLIENT_SECRET_FILE	Plik z sekretem klienta, maksymalnie 4096 bajtów. Pomiń dla klienta publicznego.	brak
HOLYARRS_OIDC_REDIRECT_URL	Dokładny adres zwrotny: twój adres, URL base jeśli jest, potem /api/v1/auth/oidc/callback.	brak
HOLYARRS_OIDC_ALLOW_JOIN	Nowe osoby dołączają jako członkowie, którzy mogą tylko prosić.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	Pozwala na dostawcę w twojej sieci prywatnej.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	Pozwala na zwykłe HTTP na tym komputerze, do testów.	false
HOLYARRS_FORWARD_AUTH_ENABLED	Włącza logowanie przez zaufane proxy.	false
HOLYARRS_FORWARD_AUTH_ISSUER	Stała nazwa HTTPS proxy.	brak
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	Adresy lub zakresy proxy, które mogą wysyłać nagłówki tożsamości, oddzielone przecinkami.	brak
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	Nowe nazwy z proxy dołączają jako członkowie, którzy mogą tylko prosić.	false

Błędna konfiguracja uniemożliwia start HolyArrs. Kroki znajdziesz na stronie Logowanie i hasła.

Dla zaawansowanych

Metadane

Zmienna	Co robi	Domyślnie
HOLYARRS_METADATA_URL	Adres serwera metadanych.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	Twój własny token TMDB z dostępem do odczytu. Gdy jest ustawiony, odczyty z TMDB idą prosto do TMDB zamiast przez serwer metadanych.	brak
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	Plik z danymi dostępu tej instalacji do serwera metadanych, czytany przy każdym wywołaniu. Bez ustawienia dane leżą w sejfie.	brak

Skróty przy pierwszym uruchomieniu

Każda dodaje jedną rzecz przy starcie. Służą do demo i testów; kreator pierwszego uruchomienia robi to samo.

Zmienna	Dodaje
HOLYARRS_MOVIES	Folder biblioteki z filmami.
HOLYARRS_QBITTORRENT_URL	Downloader qBittorrent.
HOLYARRS_SOURCE_URL	Źródło Torznab bez klucza.

Zmienne dla deweloperów i testów

Kierują HolyArrs do zastępczych usług na czas testów. Na prawdziwej instalacji zostaw je nieustawione.

Zmienna	Co robi
HOLYARRS_FLAGS	Przełączniki oddzielone przecinkami dla funkcji, które w tej wersji są domyślnie wyłączone. Zobacz Aktualizacje.
HOLYARRS_DIRECT_SOURCES	1 pozwala tej instalacji samej pytać źródła muzyki i seriali zamiast serwera metadanych.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	Pozwala na serwer metadanych w sieci lokalnej.
HOLYARRS_METADATA_COUNT	Liczy i zapisuje w logu zapytania o metadane.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	Testowy plik z tokenem TMDB i adres zastępczy.
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	Adresy zastępcze dla zewnętrznych usług.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	Czas przebiegu zwiastunów jako czas trwania, na przykład 2s.

Powiązane strony

• Instalacja
• Uruchomienie pod ścieżką
• Logowanie i hasła