업데이트

처음이라면

HolyArrs는 새 버전이 나오면 알려 주기만 하고 직접 설치하지는 않습니다. 새 이미지는 편한 때에 직접 받으면 됩니다.

새 버전이 나왔는지 확인하기

Status(상태) 페이지(http://your-server:6262/health)를 여세요.
Updates(업데이트)를 읽으세요. 다음 중 하나가 표시됩니다.

메시지	의미
“HolyArrs 1.2.0 is out, newer than this one.”(HolyArrs 1.2.0이 나왔고 지금 버전보다 새 버전입니다.)	준비되면 업데이트하세요
“This is the newest version.”(최신 버전입니다.)	할 일이 없습니다
“No HolyArrs release is published yet.”(아직 공개된 HolyArrs 릴리스가 없습니다.)	피드가 비어 있습니다. 문제는 없습니다
“The last check did not work: …”(마지막 확인에 실패했습니다: …)	피드에 닿지 못했습니다. 대개 인터넷이 끊긴 경우입니다
“The update check is off: …”(업데이트 확인이 꺼져 있습니다: …)	설정에서 꺼져 있습니다

지금 확인하려면 Check now(지금 확인) 또는 Check again(다시 확인)을 선택하세요. Change settings(설정 변경) 권한이 필요합니다.

새 버전이 있으면 상태 경고로도 표시됩니다. 실패한 확인은 Updates 아래에만 표시됩니다.

업데이트하기

새 이미지를 받고 재시작하세요. docker compose pull을 실행한 다음 docker compose up -d를 실행합니다.
HolyArrs가 시작됩니다. 새 버전이 데이터 저장 방식을 바꾸는 경우 먼저 백업을 만든 다음 데이터를 업데이트합니다. 앱이 새 버전으로 열립니다.

이전 버전으로 되돌리기

HolyArrs는 자기 이미지를 스스로 바꿀 수 없습니다. 그래서 이전 이미지는 직접 실행하고, 이전 데이터는 HolyArrs가 되돌려 놓습니다.

compose 파일(또는 docker run)의 이미지 태그를 이전 것으로 바꾸세요. 예: holyarrs/holyarrs:<older version>.
docker compose up -d를 실행하세요.
업데이트가 데이터를 바꾸지 않았다면 이전 버전이 시작됩니다. 이것으로 끝입니다.
그렇지 않으면 이전 버전이 앱 대신 페이지 하나를 보여 줍니다. Put back the data from before the update(업데이트 전 데이터 되돌려 놓기)를 선택하세요.
일회용 코드를 입력하세요. 코드는 docker logs <container>로 찾습니다. “one-time code”(일회용 코드)를 찾으세요.
HolyArrs가 백업을 확인하고 제자리에 넣은 뒤 멈춥니다. 컨테이너가 재시작 정책에 따라 그 데이터로 다시 시작됩니다. 재시작 정책이 없으면 직접 시작하세요.

페이지 없이 하려면 docker exec <container> /holyarrs restore --pre-update를 실행한 다음 docker restart <container>를 실행하세요. Docker 없이 하려면 HolyArrs를 중지하고 holyarrs restore --pre-update를 실행한 뒤 다시 시작하세요.

삭제되는 것은 없습니다. 새 버전의 데이터는 backups/before-restore-<time>/로 옮겨지므로 되돌린 것을 다시 취소할 수 있습니다. 두 버전 이상 뒤로 가면 그 버전이 읽을 수 있는 업데이트 전 백업 중 가장 최근 것이 선택됩니다.

선택 사항

모두 Settings > Health checks(설정 > 상태 점검)에 있습니다. 마지막 세 가지는 카드의 고급 영역에 있습니다.

설정	기본값	이럴 때 바꾸세요
Check for a newer HolyArrs(새 HolyArrs 확인)	켜짐	외부로 나가는 요청을 아예 없애고 싶을 때
Check for updates every(업데이트 확인 주기)	1일	확인 횟수를 줄이고 싶을 때: 3일, 7일, 14일 또는 30일
Release feed(릴리스 피드)	비어 있음(HolyArrs 릴리스)	피드를 직접 호스팅할 때
Feed may be on the local network(피드가 로컬 네트워크에 있어도 됨)	꺼짐	피드가 내 네트워크 안에 있을 때
Include test versions (like 1.2.0-rc1)(1.2.0-rc1 같은 테스트 버전 포함)	꺼짐	테스트 버전 알림도 받고 싶을 때

문제가 생기면

증상: “The last check did not work.” 원인: 서버에 인터넷이 없거나, 직접 운영하는 피드가 로컬 네트워크에 있습니다. 해결: 인터넷 연결을 확인하거나 Feed may be on the local network를 켜세요.

증상: 릴리스 피드가 저장되지 않습니다. 원인: 주소에 이름, 비밀번호, ?query 또는 #fragment가 들어 있거나, http:// 또는 https://로 시작하지 않습니다. 해결: 그 부분을 지우세요.

증상: 디스크 용량이 부족해 업데이트가 멈췄습니다. 원인: 사본과 업데이트를 담을 공간이 없습니다. 해결: 설정 폴더가 있는 곳의 여유 공간을 늘린 다음 다시 시작하세요.

증상: 되돌리기 페이지가 코드를 받아 주지 않습니다. 원인: 오래된 코드이거나, 마지막 시작 이후 틀린 코드를 10번 입력했습니다. 해결: 가장 최근 로그 줄에서 코드를 복사하세요. 10번 틀린 뒤에는 컨테이너를 재시작하고 새 코드를 쓰세요.

보류된 기능

이번 릴리스에서 일부 기능은 기본값으로 꺼져 있습니다. 켜는 데 따르는 위험은 직접 감수해야 합니다. 보류된 동안에는 해당 페이지와 메뉴 항목이 숨겨지고, API 경로는 “not found”(찾을 수 없음)로 응답하며, 작업은 실행되지 않습니다. 그 기능용으로 저장한 데이터는 그대로 남습니다.

기능을 켜려면 해당 스위치를 HOLYARRS_FLAGS에 쉼표로 구분해 추가하고 컨테이너를 재시작하세요.

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

끄려면 이름을 지우고 재시작하세요. 숨겨진 설정은 다시 켜면 돌아옵니다.

스위치	기능
`plex_watchlists`	Plex 워치리스트가 요청으로 바뀝니다
`row_title_stats`	Appearance(모양)의 둘러보기 행 작품 통계
`trakt_lists`	Trakt 키, Trakt 목록, Trakt 리뷰. TMDB 목록은 계속 켜져 있습니다
`alert_channels_more`	Telegram, ntfy, Gotify, Pushover, 웹훅 알림. Discord와 이메일은 계속 켜져 있습니다
`subtitle_sites`	자막 사이트와 자막 검색. 자막 언어 설정은 계속 켜져 있습니다
`emby_signin`	Emby로 로그인. Emby 라이브러리 새로 고침은 계속 됩니다
`go_back`	상태 페이지의 Go back(이전 버전으로 되돌리기) 패널. 이전 버전으로 되돌리기의 단계는 이 패널 없이도 됩니다

스위치를 추가했는데 바뀐 것이 없나요? 철자(소문자, 밑줄)를 확인하고, 페이지만이 아니라 컨테이너를 재시작하세요.

전문가용

확인할 때 보내는 내용

최신 릴리스를 알아보려고 api.github.com에 요청을 한 번 보내며, User-Agent: HolyArrs/<version>만 담습니다. 계정, 키, 미디어 목록은 보내지 않습니다. 확인을 끄면 요청을 전혀 보내지 않습니다.

마지막 응답은 저장되므로, 재시작해도 때가 되기 전에는 확인하지 않습니다. 확인 한 번은 최대 15 s 기다리고, 최대 512 KB를 읽고, 리디렉션을 최대 3번 따라가며, http와 https 사이를 오가지 않습니다. 릴리스 노트 링크는 GitHub의 HolyArrs 릴리스 페이지를 가리킬 때만 표시됩니다. 그렇지 않으면 버전이 일반 텍스트로 표시됩니다.

Release feed는 GitHub 형식의 릴리스 응답, 릴리스 목록, version이 들어 있는 모든 JSON, 버전이 들어 있는 일반 텍스트를 받습니다. 클라우드 메타데이터 주소는 항상 거부됩니다. 테스트 버전은 같은 번호의 정식 버전보다 오래된 것으로 칩니다.

업데이트 전 백업

저장된 데이터를 바꾸기 전에 HolyArrs는 다음을 합니다.

사본과 업데이트를 담을 공간이 있는지 확인합니다. 없으면 아무것도 바뀌지 않습니다. HOLYARRS_SKIP_SPACE_CHECK=yes로 건너뛸 수 있습니다.
각 데이터베이스를 backups에 복사하고, 사본을 확인하고, 그 옆에 sha256 파일을 씁니다. 복사가 3번 실패하면 아무것도 바뀌지 않습니다.
업데이트 단계를 하나씩 따로 실행하고 확인합니다. 실패한 단계는 되돌려지고, 끝난 단계는 그대로 남습니다. 같은 버전을 다시 시작하면 같은 사본으로 실패한 단계부터 이어 갑니다.

처음으로 정상 시작한 뒤 사본은 holyarrs-backup-pre-update-<time>.zip이 되고, “before updating from 1.1.0 to 1.2.0”(1.1.0에서 1.2.0으로 업데이트하기 전)처럼 설명이 붙습니다. Settings > Backups(설정 > 백업)와 holyarrs restore --list에 표시됩니다. 최근 3개가 보관되며, 백업 일정은 이 백업을 지우지 않습니다. 새로 설치했거나 데이터를 건드리지 않는 업데이트라면 만들어지지 않습니다.