Ажурирања

HolyArrs ти јавља када је изашла нова верзија, али је никад не инсталира. Нову слику контејнера повучеш када теби одговара.

Погледај да ли је изашла нова верзија

1. Отвори страницу Status (статус) (http://your-server:6262/health).
2. Прочитај Updates (ажурирања). Требало би да видиш једну од ових порука:

Порука	Значење
“HolyArrs 1.2.0 is out, newer than this one.”	Ажурирај када ти одговара
“This is the newest version.”	Нема шта да се ради
“No HolyArrs release is published yet.”	Фид је празан. Ништа није погрешно
“The last check did not work: …”	Фид није доступан, најчешће нема интернета
“The update check is off: …”	Искључено у подешавањима

3. Да провериш одмах, кликни на Check now (провери одмах) (или Check again, провери поново). Потребна је дозвола Change settings (промена подешавања).

Новија верзија се приказује и као упозорење о исправности. Неуспела провера види се само под Updates.

Ажурирај

1. Повуци нову слику контејнера и поново покрени: docker compose pull, па docker compose up -d.
2. HolyArrs се покреће. Ако нова верзија мења начин чувања података, прво направи бекап, па ажурира податке. Требало би да видиш да се апликација отвара на новој верзији.

Tip

Неуспео корак ажурирања се поништава и HolyArrs стаје на страници која каже шта се догодило. Твоји подаци од пре ажурирања остају као бекап.

Врати се на старију верзију

HolyArrs не може сам да промени своју слику контејнера, па ти покренеш старију слику, а HolyArrs врати старије податке.

Caution

Све што је промењено после ажурирања, као што су нови наслови, подешавања и историја, није у бекапу направљеном пре ажурирања.

1. Промени таг слике контејнера у свом compose фајлу (или у docker run) на старији, на пример holyarrs/holyarrs:<older version>.
2. Изврши docker compose up -d.
3. Ако ажурирање није променило податке, старија верзија се покреће. Готово.
4. У супротном, старија верзија уместо апликације приказује страницу. Кликни на Put back the data from before the update (врати податке од пре ажурирања).
5. Унеси једнократни код. Пронађи га са docker logs <container>; потражи „one-time code“.
6. 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)	On	Не желиш ниједан спољни захтев
Check for updates every (проверавај ажурирања на сваких)	day	Желиш мање провера: 3, 7, 14 или 30 дана
Release feed (фид верзија)	Empty (HolyArrs releases)	Сам хостујеш свој фид
Feed may be on the local network (фид може бити на локалној мрежи)	Off	Твој фид је на твојој мрежи
Include test versions (like 1.2.0-rc1) (укључи тест верзије)	Off	Желиш обавештења о тест верзијама

Ако не ради

Симптом: „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"

Уклони име и поново покрени да је искључиш. Сакривена подешавања се враћају када је поново укључиш.

Прекидач	Функција
row_title_stats	Статистика наслова у реду Explore у Appearance
trakt_lists	Trakt кључ, Trakt листе и Trakt рецензије. TMDB листе остају укључене
alert_channels_more	Telegram, ntfy, Gotify, Pushover и webhook обавештења. Discord и имејл остају укључени
subtitle_sites	Сајтови за титлове и претрага титлова. Твој језик титлова остаје укључен
emby_signin	Пријава преко Emby-ја. Освежавање Emby библиотеке и даље ради
go_back	Панел Go back (врати се) на страници Status. Кораци у Врати се раде и без њега

Ништа се није променило после додавања прекидача? Провери правопис (мала слова, доње црте) и поново покрени контејнер, не само страницу.

За напредне

Шта провера шаље

Један захтев ка api.github.com за најновију верзију, само са User-Agent: HolyArrs/<version>. Без налога, кључа или листе медија. Када је провера искључена, нема никаквог захтева.

Последњи одговор се чува, па рестарт не проверава пре времена. Једна провера чека највише 15 s, чита највише 512 KB и прати највише 3 преусмеравања, никад не прелазећи са http на https или обрнуто. Линк ка напоменама о верзији приказује се само када води на странице HolyArrs верзија на GitHub-у; иначе се верзија приказује као обичан текст.

Release feed прихвата одговор у GitHub стилу, листу верзија, било који JSON са version, или обичан текст који садржи верзију. Адресе cloud метаподатака се увек одбијају. Тест верзија се рачуна као старија од обичне верзије.

Бекап пре ажурирања

Пре промене сачуваних података, HolyArrs:

1. Проверава да ли има места за копију и ажурирање. Ако нема, ништа се не мења. Прескочи са HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Копира сваку базу података у backups, проверава копију и поред ње пише sha256 фајл. После 3 неуспела копирања, ништа се не мења.
3. Извршава сваки корак ажурирања посебно и проверава га. Неуспео корак се поништава; завршени кораци остају. Поново покрени исту верзију да наставиш од неуспелог корака са истом копијом.

После првог исправног покретања копија постаје holyarrs-backup-pre-update-<time>.zip, са описом као „before updating from 1.1.0 to 1.2.0“. Приказује се у Settings > Backups и у holyarrs restore --list. Чувају се најновија 3; распоред бекапа их никад не уклања. Нова инсталација или ажурирање које не дира податке не прави ниједну.

Провери слику контејнера

Од 1.0.3 надаље, сваку слику контејнера на Docker Hub-у потписује процес објављивања верзије на GitHub-у. Нема кључа за преузимање. Провери слику контејнера помоћу cosign. Тамо где пише <version> стави верзију коју користиш, на пример 1.0.3:

cosign verify holyarrs/holyarrs:<version> \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/HolyArrs/HolyArrs/\.github/workflows/sign\.yml@refs/(tags/[0-9.]+|heads/main)$'

Требало би да видиш The cosign claims were validated. Све друго значи да слика контејнера није дошла из процеса објављивања верзије HolyArrs: немој је покретати.

Слика контејнера носи и запис о томе како је направљена и списак онога што је у њему (SBOM). Провери их помоћу GitHub CLI:

gh attestation verify oci://docker.io/holyarrs/holyarrs:<version> --repo HolyArrs/HolyArrs

Исти фајлови су на свакој GitHub верзији: .sigstore.json (потпис), .intoto.jsonl (запис градње) и .sbom.spdx.json (садржај).

Повезане странице

• Бекапи
• Провере исправности
• Модули и безбедни режим