환경 변수

전문가

HolyArrs 컨테이너가 읽는 모든 변수입니다. 대부분은 PUID, PGID, TZ만 설정하면 됩니다.

자주 쓰는 변수

변수	하는 일	기본값	예시
`PUID`, `PGID`	HolyArrs를 실행하는 사용자와 그룹입니다. `/config`와 미디어 폴더의 소유자여야 합니다.	`1000`, `1000`	`PUID=1000`
`TZ`	일정과 로그에 쓰는 시간대입니다.	`Etc/UTC`	`TZ=Europe/Amsterdam`
`UMASK`	새 파일에서 빼는 권한 비트입니다. 새 파일에만 적용됩니다.	`022`	`UMASK=002`
`HOLYARRS_SAVE_PATH`	다운로더 쪽에서 보이는 다운로더의 저장 폴더입니다. 다운로드마다 함께 보냅니다.	없음	`/data/downloads`
`HOLYARRS_URL_BASE`	리버스 프록시 뒤에서 HolyArrs를 하위 경로로 제공합니다. `/`로 두면 설정에 저장된 경로를 무시합니다.	없음	`/holyarrs`
`HOLYARRS_ALLOWED_HOSTS`	HolyArrs에 접속할 때 쓰는 추가 호스트 이름입니다. 쉼표로 구분합니다.	IP와 `localhost`	`holyarrs.example.com`
`HOLYARRS_TRUSTED_PROXIES`	리버스 프록시의 주소나 네트워크입니다. 쉼표로 구분합니다. 실제 클라이언트 주소를 알려면 필요합니다.	없음	`172.18.0.0/16`
`HOLYARRS_MASTER_KEY_FILE`	금고의 마스터 키를 별도 파일에서 읽습니다. `PUID` 사용자가 읽을 수 있어야 합니다.	`/config/holyarrs.key`	`/keys/holyarrs.key`

파일에서 값 읽기

어떤 변수든 앞에 FILE__을 붙이면 Docker secret 같은 파일에서 값을 읽습니다.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs는 파일 끝의 줄바꿈 하나를 지웁니다. 파일이 없으면 HolyArrs가 멈추고, 로그에는 변수와 파일 이름만 남습니다. 값은 남지 않습니다.

복원과 문제 해결

변수	하는 일	기본값	예시
`HOLYARRS_SAFE_MODE`	핵심 기능만 시작합니다: 로그인, 라이브러리, 설정, 백업, 상태 점검. 문제를 고친 뒤에는 지우세요.	꺼짐	`1`
`HOLYARRS_LOW_MEMORY`	`1`은 저메모리 모드를 강제로 켜고 `0`은 강제로 끕니다. 설정하지 않으면 RAM이 약 2.5 GiB 이하일 때 켜집니다.	장비 크기에 따름	`1`
`GOMEMLIMIT`	HolyArrs가 스스로 정한 메모리 목표를 바꿉니다.	HolyArrs가 설정	`1GiB`
`HOLYARRS_SKIP_SPACE_CHECK`	데이터베이스 업데이트 전의 여유 공간 확인을 건너뜁니다.	꺼짐	`yes`
`HOLYARRS_CONFIG_IN_MEMORY`	`/config`를 메모리 기반 폴더에 두는 것을 허용합니다. 테스트 장비용이며 재시작하면 데이터가 사라집니다.	꺼짐	`yes`
`HOLYARRS_ALLOW_DESKTOP_FOLDER`	Mac에서 `/config`가 Docker Desktop 공유 폴더에 있어도 시작합니다. 그 폴더에서 파일 잠금이 되는지 먼저 확인하세요. HolyArrs는 시작할 때마다 경고합니다.	꺼짐	`1`
`HOLYARRS_READONLY_DOWNLOADERS`	HolyArrs가 절대 바꾸면 안 되는 다운로더입니다. id나 주소로 적고 쉼표로 구분합니다.	없음	`3,http://qbit:8080`
`HOLYARRS_HEALTH_URL`	컨테이너 상태 점검이 호출하는 주소입니다.	`http://127.0.0.1:6262`	`http://127.0.0.1:6262/holyarrs`

켜고 끄는 변수는 1, true, yes, on을 받습니다.

통합 로그인(SSO)

시작 전에 설정하세요. HOLYARRS_OIDC_ENABLED가 있기만 하면, 값이 false여도 통합 로그인은 환경 변수가 관리하고 설정에서는 보기만 할 수 있습니다. 여기의 켜고 끄는 변수는 true나 false만 받습니다. 다른 값이면 시작이 멈춥니다.

변수	하는 일	기본값
`HOLYARRS_OIDC_ENABLED`	통합 로그인을 켭니다.	`false`
`HOLYARRS_OIDC_ISSUER`	제공자의 정확한 HTTPS issuer입니다.	없음
`HOLYARRS_OIDC_CLIENT_ID`	등록한 client id입니다.	없음
`HOLYARRS_OIDC_CLIENT_SECRET_FILE`	client secret이 든 파일입니다. 최대 4096바이트입니다. 공개 클라이언트라면 비워 두세요.	없음
`HOLYARRS_OIDC_REDIRECT_URL`	정확한 콜백 주소입니다: 내 주소, URL base가 있으면 그다음, 이어서 `/api/v1/auth/oidc/callback`.	없음
`HOLYARRS_OIDC_ALLOW_JOIN`	새로 온 사람이 요청만 할 수 있는 멤버로 가입합니다.	`false`
`HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK`	사설 네트워크에 있는 제공자를 허용합니다.	`false`
`HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP`	테스트용으로 이 장비 안의 일반 HTTP를 허용합니다.	`false`
`HOLYARRS_FORWARD_AUTH_ENABLED`	신뢰하는 프록시를 통한 로그인을 켭니다.	`false`
`HOLYARRS_FORWARD_AUTH_ISSUER`	프록시를 가리키는 고정된 HTTPS 이름입니다.	없음
`HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS`	신원 헤더를 보낼 수 있는 프록시 주소나 범위입니다. 쉼표로 구분합니다.	없음
`HOLYARRS_FORWARD_AUTH_ALLOW_JOIN`	프록시가 알려 준 새 이름이 요청만 할 수 있는 멤버로 가입합니다.	`false`

설정이 잘못되면 HolyArrs가 시작하지 않습니다. 순서는 로그인과 비밀번호에 있습니다.

전문가용

메타데이터

변수	하는 일	기본값
`HOLYARRS_METADATA_URL`	메타데이터 서버 주소입니다.	`https://api.holyarrs.com`
`HOLYARRS_TMDB_KEY`	직접 발급받은 TMDB 읽기 액세스 토큰입니다. 설정하면 TMDB 조회가 메타데이터 서버 대신 TMDB로 바로 갑니다.	없음
`HOLYARRS_METADATA_SERVICE_TOKEN_FILE`	이 설치의 메타데이터 서버 인증 정보가 든 파일입니다. 호출할 때마다 읽습니다. 설정하지 않으면 인증 정보는 금고에 보관됩니다.	없음

첫 시작 바로가기

변수마다 시작할 때 항목 하나를 추가합니다. 데모와 테스트에 쓰며, 첫 실행 마법사도 같은 일을 합니다.

변수	추가하는 것
`HOLYARRS_MOVIES`	영화 라이브러리 폴더.
`HOLYARRS_QBITTORRENT_URL`	qBittorrent 다운로더.
`HOLYARRS_SOURCE_URL`	키가 없는 Torznab 소스.

개발자와 테스트용 변수

테스트할 때 HolyArrs가 실제 서비스 대신 대역을 보게 합니다. 실제 설치에서는 설정하지 마세요.

변수	하는 일
`HOLYARRS_FLAGS`	이번 릴리스에서 기본으로 꺼져 있는 기능의 스위치입니다. 쉼표로 구분합니다. 업데이트를 보세요.
`HOLYARRS_DIRECT_SOURCES`	`1`이면 이 설치가 메타데이터 서버를 거치지 않고 음악과 TV 소스에 직접 물어봅니다.
`HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL`	로컬 네트워크에 있는 메타데이터 서버를 허용합니다.
`HOLYARRS_METADATA_COUNT`	메타데이터 요청을 세고 로그에 남깁니다.
`HOLYARRS_TMDB_TOKEN_FILE`, `HOLYARRS_TMDB_URL`	테스트용 TMDB 토큰 파일과 대역 주소입니다.
`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`	외부 서비스를 대신하는 대역 주소입니다.
`HOLYARRS_TRAILER_PASS_FIRST`, `HOLYARRS_TRAILER_PASS_EVERY`	예고편 작업의 시점입니다. `2s` 같은 시간 값으로 적습니다.