Ortam değişkenleri

HolyArrs konteynerinin okuduğu tüm değişkenler. Çoğu kurulumda sadece PUID, PGID ve TZ ayarlanır.

Yaygın olanlar

Değişken	Ne yapar	Varsayılan	Örnek
PUID, PGID	HolyArrs’ın hangi kullanıcı ve grupla çalışacağı. /config ile medya klasörlerinin sahibi olmalı.	1000, 1000	PUID=1000
TZ	Zamanlamalar ve günlükler için saat dilimi.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	Yeni dosyalardan çıkarılan izin bitleri. Sadece yeni dosyaları etkiler.	022	UMASK=002
HOLYARRS_SAVE_PATH	İndiricinin kayıt klasörü, indiricinin gördüğü haliyle. Her indirmeyle birlikte gönderilir.	yok	/data/downloads
HOLYARRS_URL_BASE	Ters proxy arkasında HolyArrs’ı bir yol altında sunar. / değeri, Ayarlar’da kayıtlı yolu yok sayar.	yok	/holyarrs
HOLYARRS_ALLOWED_HOSTS	İnsanların HolyArrs’a ulaşmak için kullandığı ek host adları, virgülle ayrılır.	IP’ler ve localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	Ters proxy’nin adresi ya da ağı, virgülle ayrılır. Gerçek istemci adreslerini görmek için gerekir.	yok	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	Kasanın ana anahtarını kendi dosyasından okur. PUID kullanıcısı bu dosyayı okuyabilmeli.	/config/holyarrs.key	/keys/holyarrs.key

Dosyadan değer okuma

Bir değişkenin değerini dosyadan (örneğin bir Docker secret’ından) okutmak için adının önüne FILE__ ekle.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs dosyanın sonundaki tek satır sonunu atar. Dosya yoksa HolyArrs durur ve günlük değişkenin ile dosyanın adını yazar, değeri asla yazmaz.

Kurtarma ve sorun giderme

Değişken	Ne yapar	Varsayılan	Örnek
HOLYARRS_SAFE_MODE	Sadece çekirdeği başlatır: giriş, Kütüphane, ayarlar, yedekler ve sağlık. Sorunu çözdükten sonra kaldır.	kapalı	1
HOLYARRS_LOW_MEMORY	1 düşük bellek modunu zorla açar, 0 zorla kapatır. Ayarlı değilse yaklaşık 2.5 GiB ya da daha az RAM’de kendiliğinden açılır.	bilgisayarın boyutuna göre	1
GOMEMLIMIT	HolyArrs’ın kendisi için koyduğu bellek hedefini değiştirir.	HolyArrs belirler	1GiB
HOLYARRS_SKIP_SPACE_CHECK	Veritabanı güncellemesinden önceki boş alan denetimini atlar.	kapalı	yes
HOLYARRS_CONFIG_IN_MEMORY	/config’in bellek destekli bir klasörde olmasına izin verir. Test bilgisayarları için; yeniden başlatınca veriler kaybolur.	kapalı	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Mac’te /config Docker Desktop paylaşımlı klasöründeyken, dosya kilitlerinin orada çalıştığını denetledikten sonra başlamasına izin verir. HolyArrs her açılışta uyarır.	kapalı	1
HOLYARRS_READONLY_DOWNLOADERS	HolyArrs’ın asla değiştirmemesi gereken indiriciler; id ya da adresle, virgülle ayrılır.	yok	3,http://qbit:8080
HOLYARRS_HEALTH_URL	Konteynerin sağlık denetiminin çağırdığı adres.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

Aç/kapat değişkenleri 1, true, yes ya da on kabul eder.

Tek oturum açma

Bunları başlatmadan önce ayarla. HOLYARRS_OIDC_ENABLED tanımlıysa, false olsa bile, tek oturum açmayı ortam yönetir ve Ayarlar yalnızca gösterir. Buradaki aç/kapat değişkenleri sadece true ya da false alır; başka bir değer başlatmayı durdurur.

Değişken	Ne yapar	Varsayılan
HOLYARRS_OIDC_ENABLED	Tek oturum açmayı açar.	false
HOLYARRS_OIDC_ISSUER	Sağlayıcının tam HTTPS issuer adresi.	yok
HOLYARRS_OIDC_CLIENT_ID	Kayıtlı istemci id’si.	yok
HOLYARRS_OIDC_CLIENT_SECRET_FILE	İstemci gizli anahtarını tutan dosya, en fazla 4096 bayt. Herkese açık istemci için boş bırak.	yok
HOLYARRS_OIDC_REDIRECT_URL	Tam callback adresi: kendi adresin, varsa URL base, ardından /api/v1/auth/oidc/callback.	yok
HOLYARRS_OIDC_ALLOW_JOIN	Yeni gelenler sadece istek yapabilen üyeler olarak katılır.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	Özel ağındaki bir sağlayıcıya izin verir.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	Test için bu bilgisayarda düz HTTP’ye izin verir.	false
HOLYARRS_FORWARD_AUTH_ENABLED	Güvenilen proxy ile girişi açar.	false
HOLYARRS_FORWARD_AUTH_ISSUER	Proxy için sabit bir HTTPS adı.	yok
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	Kimlik başlıkları göndermesine izin verilen proxy adresleri ya da aralıkları, virgülle ayrılır.	yok
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	Proxy’den gelen yeni adlar sadece istek yapabilen üyeler olarak katılır.	false

Hatalı bir kurulum HolyArrs’ın başlamasını engeller. Adımlar Giriş ve parolalar sayfasında.

Uzmanlar için

Metadata

Değişken	Ne yapar	Varsayılan
HOLYARRS_METADATA_URL	Metadata sunucusunun adresi.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	Kendi TMDB okuma erişim token’ın. Ayarlıysa TMDB okumaları metadata sunucusu yerine doğrudan TMDB’ye gider.	yok
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	Bu kurulumun metadata sunucusu kimlik bilgisini tutan dosya; her çağrıda okunur. Ayarlı değilse kimlik bilgisi kasada durur.	yok

İlk açılış kısayolları

Her biri başlangıçta bir öğe ekler. Demolar ve testler için kullanılır; ilk açılış sihirbazı da aynısını yapar.

Değişken	Ekler
HOLYARRS_MOVIES	Bir film Kütüphane klasörü.
HOLYARRS_QBITTORRENT_URL	Bir qBittorrent indiricisi.
HOLYARRS_SOURCE_URL	Anahtarsız bir Torznab kaynağı.

Geliştirici ve test değişkenleri

Bunlar HolyArrs’ı testlerdeki taklit hizmetlere yönlendirir. Gerçek bir kurulumda ayarlama.

Değişken	Ne yapar
HOLYARRS_FLAGS	Bu sürümde varsayılan olarak kapalı özellikler için virgülle ayrılmış anahtarlar. Bkz. Güncellemeler.
HOLYARRS_DIRECT_SOURCES	1, bu kurulumun müzik ve dizi kaynaklarına metadata sunucusu yerine kendisinin sormasını sağlar.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	Yerel ağdaki bir metadata sunucusuna izin verir.
HOLYARRS_METADATA_COUNT	Metadata isteklerini sayar ve günlüğe yazar.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	Test için TMDB token dosyası ve taklit adres.
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	Dış hizmetler için taklit adresler.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	Fragman turunun zamanlaması; 2s gibi süreler.

İlgili

• Kurulum
• Bir yol altında çalıştırma
• Giriş ve parolalar