Lewati ke konten

Variabel lingkungan

Mahir

Semua variabel yang dibaca container HolyArrs. Kebanyakan instalasi hanya mengatur PUID, PGID dan TZ.

Variabel Fungsinya Bawaan Contoh
PUID, PGID Pengguna dan grup tempat HolyArrs berjalan. Harus jadi pemilik /config dan folder media kamu. 1000, 1000 PUID=1000
TZ Zona waktu untuk jadwal dan log. Etc/UTC TZ=Europe/Amsterdam
UMASK Bit izin yang tidak diberikan ke file baru. Hanya berlaku untuk file baru. 022 UMASK=002
HOLYARRS_SAVE_PATH Folder simpan milik downloader, seperti yang dilihat downloader. Dikirim bersama setiap unduhan. tidak ada /data/downloads
HOLYARRS_URL_BASE Menjalankan HolyArrs di bawah sebuah path di belakang reverse proxy. / mengabaikan path yang tersimpan di Settings. tidak ada /holyarrs
HOLYARRS_ALLOWED_HOSTS Nama host tambahan yang dipakai orang untuk membuka HolyArrs, dipisah koma. IP dan localhost holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES Alamat atau jaringan reverse proxy kamu, dipisah koma. Dibutuhkan agar alamat klien yang asli terbaca. tidak ada 172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE Membaca kunci utama vault dari file tersendiri. Pengguna PUID harus bisa membacanya. /config/holyarrs.key /keys/holyarrs.key

Tambahkan FILE__ di depan variabel apa pun untuk membaca nilainya dari file, misalnya Docker secret.

environment:
- FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs membuang satu baris baru di akhir file. Kalau file tidak ada, HolyArrs berhenti dan log menyebut nama variabel dan file, tidak pernah nilainya.

Pemulihan dan pemecahan masalah

Tautan ke Pemulihan dan pemecahan masalah
Variabel Fungsinya Bawaan Contoh
HOLYARRS_SAFE_MODE Hanya menjalankan inti: login, pustaka, pengaturan, backup, dan kondisi. Hapus setelah masalah beres. nonaktif 1
HOLYARRS_LOW_MEMORY 1 memaksa mode memori rendah aktif, 0 memaksanya nonaktif. Kalau tidak diatur, mode ini aktif pada RAM sekitar 2.5 GiB atau kurang. sesuai ukuran komputer 1
HOLYARRS_FOLLOW_LINKS 1 membuat pemindaian pustaka dan impor bisa memakai file video dan musik yang berupa symlink (pustaka yang dibuat dari tautan ke drive yang di-mount). Unduhan yang tertaut ditaruh di pustaka sebagai tautan. nonaktif 1
GOMEMLIMIT Mengganti target memori yang ditetapkan HolyArrs untuk dirinya sendiri. diatur oleh HolyArrs 1GiB
HOLYARRS_SKIP_SPACE_CHECK Melewati pemeriksaan ruang kosong sebelum update database. nonaktif yes
HOLYARRS_CONFIG_IN_MEMORY Mengizinkan /config di folder yang berbasis memori. Untuk komputer uji coba; data hilang saat restart. nonaktif yes
HOLYARRS_ALLOW_DESKTOP_FOLDER Menjalankan dengan /config di folder bersama Docker Desktop pada Mac, setelah kamu memastikan file lock berfungsi di sana. HolyArrs memberi peringatan setiap kali mulai. nonaktif 1
HOLYARRS_READONLY_DOWNLOADERS Downloader yang tidak boleh diubah HolyArrs, berdasarkan id atau alamat, dipisah koma. tidak ada 3,http://qbit:8080
HOLYARRS_HEALTH_URL Alamat yang dipanggil oleh pemeriksaan kondisi container. http://127.0.0.1:6262 http://127.0.0.1:6262/holyarrs

Variabel aktif/nonaktif menerima 1, true, yes atau on.

Atur ini sebelum memulai. Kalau HOLYARRS_OIDC_ENABLED ada sama sekali, bahkan sebagai false, pengaturan single sign-on dikendalikan oleh variabel lingkungan, dan Settings hanya menampilkannya. Variabel aktif/nonaktif di sini hanya menerima true atau false; nilai lain membuat HolyArrs gagal mulai.

Variabel Fungsinya Bawaan
HOLYARRS_OIDC_ENABLED Mengaktifkan single sign-on. false
HOLYARRS_OIDC_ISSUER Issuer HTTPS dari penyedia, harus persis sama. tidak ada
HOLYARRS_OIDC_CLIENT_ID Id klien yang terdaftar. tidak ada
HOLYARRS_OIDC_CLIENT_SECRET_FILE File berisi rahasia klien, maksimal 4096 byte. Kosongkan untuk klien publik. tidak ada
HOLYARRS_OIDC_REDIRECT_URL Callback yang persis: alamat kamu, URL base kalau ada, lalu /api/v1/auth/oidc/callback. tidak ada
HOLYARRS_OIDC_ALLOW_JOIN Orang baru bergabung sebagai anggota yang hanya bisa meminta. false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK Mengizinkan penyedia di jaringan pribadi kamu. false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP Mengizinkan HTTP biasa di komputer ini, untuk pengujian. false
HOLYARRS_FORWARD_AUTH_ENABLED Mengaktifkan login lewat proxy tepercaya. false
HOLYARRS_FORWARD_AUTH_ISSUER Nama HTTPS yang stabil untuk proxy. tidak ada
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS Alamat atau rentang proxy yang boleh mengirim header identitas, dipisah koma. tidak ada
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN Nama proxy baru bergabung sebagai anggota yang hanya bisa meminta. false

Penyiapan yang salah membuat HolyArrs tidak mau mulai. Langkah-langkahnya ada di Login dan kata sandi.

Metadata
Variabel Fungsinya Bawaan
HOLYARRS_METADATA_URL Alamat server metadata. https://api.holyarrs.com
HOLYARRS_TMDB_KEY Token akses baca TMDB milik kamu sendiri. Kalau diatur, pembacaan TMDB langsung ke TMDB, bukan lewat server metadata. tidak ada
HOLYARRS_METADATA_SERVICE_TOKEN_FILE File berisi kredensial server metadata untuk instalasi ini, dibaca pada setiap panggilan. Kalau tidak diatur, kredensial disimpan di vault. tidak ada

Apa yang masih lewat server metadata dengan kunci TMDB milik kamu sendiri, dan setiap alamat luar lainnya, ada di Alamat luar.

Pintasan saat pertama kali dijalankan

Masing-masing menambahkan satu item saat mulai. Dipakai untuk demo dan pengujian; wizard pertama kali dijalankan melakukan hal yang sama.

Variabel Menambahkan
HOLYARRS_MOVIES Sebuah folder pustaka film.
HOLYARRS_QBITTORRENT_URL Sebuah downloader qBittorrent.
HOLYARRS_SOURCE_URL Sebuah sumber Torznab tanpa kunci.
Variabel untuk developer dan pengujian

Variabel ini mengarahkan HolyArrs ke layanan tiruan untuk pengujian. Biarkan tidak diatur pada instalasi yang sebenarnya.

Variabel Fungsinya
HOLYARRS_FLAGS Sakelar yang dipisah koma untuk fitur yang nonaktif secara bawaan di versi ini. Lihat Update.
HOLYARRS_DIRECT_SOURCES 1 membuat instalasi ini bertanya sendiri ke sumber musik dan TV, tidak lewat server metadata.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL Mengizinkan server metadata di jaringan lokal.
HOLYARRS_METADATA_COUNT Menghitung dan mencatat di log permintaan metadata.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL File token TMDB untuk uji coba dan alamat tiruannya.
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 Alamat tiruan untuk layanan luar.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY Waktu putaran trailer dalam bentuk durasi, seperti 2s.

HolyArrs gratis. Kalau ini menghemat waktumu, beri bintang di GitHub, jadi sponsor atau traktir saya kopi.