Uppfærslur

HolyArrs lætur þig vita þegar ný útgáfa er komin og setur hana aldrei upp sjálfkrafa. Þú sækir nýja image þegar þér hentar.

Athuga hvort ný útgáfa er komin

1. Opnaðu Status (staða) síðuna (http://your-server:6262/health).
2. Lestu Updates (uppfærslur). Þú ættir að sjá eitt af þessu:

Skilaboð	Merking
“HolyArrs 1.2.0 is out, newer than this one.”	Uppfærðu þegar þér hentar
“This is the newest version.”	Ekkert að gera
“No HolyArrs release is published yet.”	Straumurinn er tómur. Ekkert er að
“The last check did not work: …”	Straumurinn næst ekki, oft vegna þess að internetið vantar
“The update check is off: …”	Slökkt í stillingum

3. Til að athuga strax skaltu smella á Check now (athuga núna) eða Check again (athuga aftur). Það krefst heimildarinnar Change settings (breyta stillingum).

Nýrri útgáfa birtist líka sem heilsuviðvörun. Misheppnuð athugun birtist aðeins undir Updates.

Uppfæra

1. Sæktu nýju image og endurræstu: docker compose pull, síðan docker compose up -d.
2. HolyArrs ræsist. Ef nýja útgáfan breytir því hvernig gögn eru vistuð býr hún fyrst til backup og uppfærir svo gögnin. Þú ættir að sjá forritið opnast á nýju útgáfunni.

Tip

Misheppnað uppfærsluskref er afturkallað og HolyArrs stöðvast á síðu sem segir hvað gerðist. Gögnin þín frá því fyrir uppfærsluna haldast sem backup.

Fara aftur í eldri útgáfu

HolyArrs getur ekki skipt um sína eigin image, svo þú keyrir eldri image og HolyArrs setur eldri gögnin aftur á sinn stað.

Caution

Allt sem breytist eftir uppfærsluna, eins og nýir titlar, stillingar og saga, er ekki í backup frá því fyrir uppfærsluna.

1. Breyttu image tag í compose-skránni þinni (eða docker run) í þá eldri, til dæmis holyarrs/holyarrs:<older version>.
2. Keyrðu docker compose up -d.
3. Ef uppfærslan breytti ekki gögnunum ræsist eldri útgáfan. Þá er þessu lokið.
4. Annars sýnir eldri útgáfan síðu í stað forritsins. Smelltu á Put back the data from before the update (setja aftur gögnin frá því fyrir uppfærsluna).
5. Sláðu inn einnota kóðann. Þú finnur hann með docker logs <container>; leitaðu að „one-time code“.
6. HolyArrs athugar backup, setur það á sinn stað og stöðvast. Þú ættir að sjá container ræsast aftur á þeim gögnum vegna endurræsingarstefnunnar (restart policy). Án hennar skaltu ræsa container-inn handvirkt.

Án síðunnar: docker exec <container> /holyarrs restore --pre-update, síðan docker restart <container>. Án Docker: stöðvaðu HolyArrs, keyrðu holyarrs restore --pre-update og ræstu HolyArrs aftur.

Engu er eytt. Nýrri gögnin færast í backups/before-restore-<time>/, svo þú getur afturkallað. Ef þú ferð aftur um fleiri en eina útgáfu velur HolyArrs nýjasta backup frá því fyrir uppfærslu sem sú útgáfa getur lesið.

Valkostir

Allt er í Settings > Health checks (stillingar > heilsuathuganir). Síðustu þrjár stillingarnar eru undir ítarlega hluta spjaldsins.

Stilling	Sjálfgefið	Breyttu henni þegar
Check for a newer HolyArrs (athuga hvort ný útgáfa af HolyArrs er til)	Kveikt	Þú vilt enga utanaðkomandi beiðni
Check for updates every (athuga með uppfærslur á hverjum)	dagur	Þú vilt færri athuganir: 3, 7, 14 eða 30 daga
Release feed (útgáfustraumur)	Tómt (útgáfur HolyArrs)	Þú hýsir þinn eigin straum
Feed may be on the local network (straumur má vera á staðarneti)	Slökkt	Straumurinn þinn er á þínu eigin neti
Include test versions (like 1.2.0-rc1) (taka með prufuútgáfur, eins og 1.2.0-rc1)	Slökkt	Þú vilt fá tilkynningar um prufuútgáfur

Ef það virkar ekki

Einkenni: „The last check did not work.“ Orsök: tölvan hefur ekki aðgang að internetinu, eða þinn eigin straumur er á staðarneti. Lausn: athugaðu nettenginguna, eða kveiktu á Feed may be on the local network.

Einkenni: útgáfustraumurinn vistast ekki. Orsök: vistfangið inniheldur notandanafn, lykilorð, ?query eða #fragment, eða byrjar ekki á http:// eða https://. Lausn: fjarlægðu þá hluta.

Einkenni: uppfærslan stöðvaðist vegna plássleysis. Orsök: ekki er nóg pláss fyrir backup og uppfærsluna. Lausn: losaðu pláss þar sem stillingamappan er og ræstu aftur.

Einkenni: síðan til að fara aftur hafnar kóðanum þínum. Orsök: gamall kóði, eða 10 rangir kóðar frá síðustu ræsingu. Lausn: afritaðu kóðann úr nýjustu log-línunni. Eftir 10 röng skipti skaltu endurræsa container-inn og nota nýja kóðann.

Frestaðir eiginleikar

Sumir eiginleikar eru slökktir sjálfgefið í þessari útgáfu. Kveiktu á þeim á eigin ábyrgð. Á meðan þeir eru frestaðir eru síður þeirra og valmyndaratriði falin, API-slóðir þeirra svara „not found“ og verkefni þeirra keyra ekki. Gögn sem þú vistaðir fyrir þá haldast.

Til að kveikja á einum skaltu bæta rofa hans við HOLYARRS_FLAGS, aðskildum með kommum, og endurræsa container-inn:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Fjarlægðu nafnið og endurræstu til að slökkva á honum. Faldar stillingar koma aftur þegar þú kveikir aftur á honum.

Rofi	Eiginleiki
row_title_stats	Tölfræði titla í röðum í Explore, stillt í Appearance
trakt_lists	Trakt-lykill, Trakt-listar og Trakt-umsagnir. TMDB-listar haldast í gangi
alert_channels_more	Tilkynningar í gegnum Telegram, ntfy, Gotify, Pushover og webhook. Discord og tölvupóstur haldast í gangi
subtitle_sites	Textasíður og leit að skjátextum. Skjátextamálið þitt helst
emby_signin	Innskráning með Emby. Uppfærsla á Emby-safninu virkar áfram
go_back	Go back (fara til baka) spjaldið á Status-síðunni. Skrefin í Fara aftur virka án þess

Breyttist ekkert eftir að þú bættir við rofa? Athugaðu stafsetninguna (lágstafir, undirstrik) og endurræstu container-inn, ekki bara síðuna.

Fyrir sérfræðinga

Hvað athugunin sendir

Ein beiðni til api.github.com um nýjustu útgáfuna, með aðeins User-Agent: HolyArrs/<version>. Enginn reikningur, lykill eða listi yfir titla. Þegar slökkt er á athuguninni er engin beiðni send.

Síðasta svarið er vistað, svo endurræsing athugar ekki áður en komið er að því. Ein athugun bíður í mesta lagi í 15 s, les í mesta lagi 512 KB og fylgir í mesta lagi 3 tilvísunum, og skiptir aldrei á milli http og https. Tengill á útgáfuskýringar birtist aðeins þegar hann bendir á útgáfusíður HolyArrs á GitHub; annars birtist útgáfan sem venjulegur texti.

Release feed (útgáfustraumur) tekur við svari í GitHub-stíl um útgáfu, lista af útgáfum, hvaða JSON sem er með version, eða hreinum texta sem inniheldur útgáfunúmerið. Cloud metadata-vistföngum er alltaf hafnað. Prufuútgáfa telst eldri en hrein útgáfa.

Backup fyrir uppfærslu

Áður en vistuðum gögnum er breytt gerir HolyArrs þetta:

1. Athugar að pláss sé fyrir backup og uppfærsluna. Ef ekki breytist ekkert. Slepptu því með HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Afritar hvern gagnagrunn í backups, athugar afritið og skrifar sha256-skrá við hliðina. Eftir 3 misheppnaðar tilraunir til að afrita breytist ekkert.
3. Keyrir hvert uppfærsluskref sérstaklega og athugar það. Misheppnað skref er afturkallað; skref sem kláruðust haldast. Ræstu sömu útgáfu aftur til að halda áfram frá misheppnaða skrefinu með sama backup.

Eftir fyrstu góðu ræsingu verður backup-ið að holyarrs-backup-pre-update-<time>.zip, með lýsingu eins og „before updating from 1.1.0 to 1.2.0“. Það birtist í Settings > Backups og í holyarrs restore --list. Nýjustu 3 eru geymd; tímaáætlun backup eyðir þeim aldrei. Ný uppsetning eða uppfærsla sem breytir ekki gögnunum býr ekkert til.

Staðfesta image

Frá og með 1.0.3 eru allar image á Docker Hub undirritaðar af útgáfukeyrslunni á GitHub. Það er enginn lykill til að sækja. Athugaðu image með cosign. Settu útgáfuna sem þú keyrir, til dæmis 1.0.3, þar sem stendur <version>:

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)$'

Þú ættir að sjá The cosign claims were validated. Allt annað þýðir að image kom ekki frá útgáfukeyrslu HolyArrs: ekki keyra það.

Image inniheldur líka skrá um hvernig það var smíðað og lista yfir það sem er í því (SBOM). Athugaðu þetta með GitHub CLI:

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

Sömu skrár eru á hverri GitHub-útgáfu: .sigstore.json (undirskrift), .intoto.jsonl (smíðaskrá) og .sbom.spdx.json (innihald).

Tengt efni

• Backup
• Heilsuathuganir
• Hlutar og öruggur hamur