Frissítések

A HolyArrs szól, ha megjelent egy új verzió, de soha nem telepíti magától. Az új image-et akkor húzod le, amikor neked jó.

Megjelent-e új verzió

1. Nyisd meg a Status (állapot) oldalt (http://your-server:6262/health).
2. Olvasd el az Updates (frissítések) részt. Az alábbiak egyikét kell látnod:

Üzenet	Jelentés
“HolyArrs 1.2.0 is out, newer than this one.”	Frissíts, ha ráérsz
“This is the newest version.”	Nincs teendő
“No HolyArrs release is published yet.”	A feed üres. Nincs hiba
“The last check did not work: …”	A feed nem érhető el, gyakran nincs internet
“The update check is off: …”	A Beállításokban ki van kapcsolva

3. Ha most akarod megkérdezni, kattints a Check now (ellenőrzés most) vagy a Check again (ellenőrzés újra) gombra. Ehhez kell a Change settings (beállítások módosítása) jogosultság.

Az újabb verzió állapotellenőrzési figyelmeztetésként is megjelenik. A sikertelen ellenőrzés csak az Updates résznél látszik.

Frissítés

1. Húzd le az új image-et, és indítsd újra: docker compose pull, majd docker compose up -d.
2. A HolyArrs elindul. Ha az új verzió megváltoztatja az adatok tárolását, előbb backupot készít, aztán frissíti az adatokat. Az appnak már az új verzióval kell megnyílnia.

Tipp

A sikertelen frissítési lépés visszaáll, a HolyArrs pedig megáll egy oldalon, amely leírja, mi történt. A frissítés előtti adataid backupként megmaradnak.

Visszatérés a korábbi verzióra

A HolyArrs nem tudja megváltoztatni a saját image-ét, ezért te futtatod a régebbi image-et, a HolyArrs pedig visszateszi a régebbi adatokat.

Figyelem

Ami a frissítés után változott, például az új címek, a beállítások és az előzmények, nincs benne a frissítés előtti backupban.

1. Írd át az image tagjét a compose fájlodban (vagy a docker run parancsban) a régebbire, például holyarrs/holyarrs:<older version>.
2. Futtasd: docker compose up -d.
3. Ha a frissítés nem változtatta meg az adatokat, a régebbi verzió elindul. Kész vagy.
4. Egyébként a régebbi verzió az app helyett egy oldalt mutat. Kattints a Put back the data from before the update (a frissítés előtti adatok visszatétele) gombra.
5. Írd be az egyszeri kódot. A docker logs <container> paranccsal találod meg, keresd az “one-time code” szöveget.
6. A HolyArrs ellenőrzi a backupot, a helyére teszi, majd leáll. A containernek az újraindítási szabálya szerint újra kell indulnia ezekkel az adatokkal. Ha nincs ilyen szabály, indítsd el te.

Az oldal nélkül: docker exec <container> /holyarrs restore --pre-update, majd docker restart <container>. Docker nélkül: állítsd le a HolyArrsot, futtasd a holyarrs restore --pre-update parancsot, majd indítsd el.

Semmi nem törlődik. Az újabb adatok a backups/before-restore-<time>/ mappába kerülnek, így visszavonhatod. Ha egynél több verziót lépsz vissza, a HolyArrs a legfrissebb olyan frissítés előtti backupot választja, amelyet az a verzió még be tud olvasni.

Lehetőségek

Mind a Settings > Health checks (Beállítások > Állapotellenőrzések) oldalon van. Az utolsó három a kártya haladó részében található.

Beállítás	Alapértelmezett	Mikor módosítsd
Check for a newer HolyArrs (új HolyArrs keresése)	On (be)	Egyáltalán nem akarsz külső kérést
Check for updates every (frissítések ellenőrzése ennyi időnként)	nap	Ritkábban akarsz ellenőrizni: 3, 7, 14 vagy 30 naponként
Release feed	Üres (HolyArrs verziók)	Saját feedet üzemeltetsz
Feed may be on the local network (a feed lehet a helyi hálózaton)	Off (ki)	A feeded a saját hálózatodon van
Include test versions (like 1.2.0-rc1) (tesztverziók is)	Off (ki)	Értesítést kérsz a tesztverziókról

Ha nem működik

Tünet: “The last check did not work.” Ok: a szervernek nincs internete, vagy a saját feeded a helyi hálózaton van. Megoldás: ellenőrizd az internetkapcsolatot, vagy kapcsold be a Feed may be on the local network beállítást.

Tünet: a release feed nem menthető. Ok: a cím felhasználónevet, jelszót, ?query vagy #fragment részt tartalmaz, vagy nem http:// vagy https:// kezdetű. Megoldás: töröld ezeket a részeket.

Tünet: a frissítés lemezhely hiánya miatt megállt. Ok: nincs elég hely a másolatnak és a frissítésnek. Megoldás: szabadíts fel helyet ott, ahol a konfigurációs mappa van, aztán indítsd újra.

Tünet: a visszatérés oldala elutasítja a kódodat. Ok: régi kódot adtál meg, vagy az utolsó indítás óta 10 hibás kódot. Megoldás: másold ki a kódot a legfrissebb log sorból. 10 hibás próbálkozás után indítsd újra a containert, és használd az új kódot.

Későbbre halasztott funkciók

Néhány funkció ebben a verzióban alapból ki van kapcsolva. Csak saját felelősségedre kapcsold be őket. Amíg halasztva vannak, az oldalaik és menüpontjaik rejtettek, az API-útvonalaik “not found” választ adnak, a feladataik pedig nem futnak. Az ezekhez elmentett adataid megmaradnak.

Bekapcsoláshoz add hozzá a kapcsolót a HOLYARRS_FLAGS változóhoz, vesszővel elválasztva, és indítsd újra a containert:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

A kikapcsoláshoz töröld a nevet, és indítsd újra. A rejtett beállítások visszajönnek, ha újra bekapcsolod.

Kapcsoló	Funkció
row_title_stats	A Felfedezés sorainak cím-statisztikái az Appearance oldalon
trakt_lists	Trakt-kulcs, Trakt-listák és Trakt-vélemények. A TMDB-listák bekapcsolva maradnak
alert_channels_more	Telegram, ntfy, Gotify, Pushover és webhook értesítések. A Discord és az e-mail bekapcsolva marad
subtitle_sites	Feliratoldalak és feliratkeresés. A feliratnyelved bekapcsolva marad
emby_signin	Bejelentkezés Embyvel. Az Emby médiatár frissítése továbbra is működik
go_back	A Go back panel a Status oldalon. A Visszatérés lépései enélkül is működnek

Nem változott semmi a kapcsoló hozzáadása után? Ellenőrizd a helyesírást (kisbetű, aláhúzás), és a containert indítsd újra, ne csak az oldalt.

Haladóknak

Mit küld az ellenőrzés

Egyetlen kérés megy az api.github.com felé a legújabb verzióért, csak a User-Agent: HolyArrs/<version> fejléccel. Nincs fiók, kulcs vagy médialista. Kikapcsolt ellenőrzésnél egyáltalán nincs kérés.

Az utolsó válasz el van mentve, így egy újraindítás nem ellenőriz az esedékesség előtt. Egy ellenőrzés legfeljebb 15 másodpercet vár, legfeljebb 512 KB-ot olvas, és legfeljebb 3 átirányítást követ, soha nem vált http és https között. A kiadási jegyzetekre mutató hivatkozás csak akkor jelenik meg, ha a HolyArrs GitHubon lévő verzióoldalaira mutat; egyébként a verzió sima szövegként látszik.

A Release feed elfogad GitHub-stílusú release-választ, release-listát, bármilyen JSON-t version mezővel, vagy a verziót tartalmazó sima szöveget. A felhős metaadat-címeket mindig elutasítja. A tesztverzió régebbinek számít, mint a sima verzió.

A frissítés előtti backup

Mielőtt a tárolt adatokat megváltoztatná, a HolyArrs:

1. Ellenőrzi, van-e hely a másolatnak és a frissítésnek. Ha nincs, semmi nem változik. Kihagyás: HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Minden adatbázist átmásol a backups mappába, ellenőrzi a másolatot, és mellé ír egy sha256 fájlt. 3 sikertelen másolás után semmi nem változik.
3. Minden frissítési lépést külön futtat és ellenőriz. A sikertelen lépés visszaáll; a kész lépések megmaradnak. Ha ugyanazt a verziót újra elindítod, a sikertelen lépéstől folytatja ugyanazzal a másolattal.

Az első sikeres indítás után a másolat holyarrs-backup-pre-update-<time>.zip lesz, ilyen leírással: “before updating from 1.1.0 to 1.2.0”. Megjelenik a Settings > Backups oldalon és a holyarrs restore --list kimenetében. A legfrissebb 3 megmarad; a backup-ütemezés ezeket soha nem törli. Új telepítésnél, vagy olyan frissítésnél, amely nem érinti az adatokat, nem készül ilyen.

Az image ellenőrzése

Az 1.0.3-tól kezdve a Docker Hubon minden image-et a GitHubon futó kiadási folyamat ír alá. Nincs letöltendő kulcs. Az image-et a cosign eszközzel ellenőrizheted. Oda, ahol <version> áll, írd be a futtatott verziót, például 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)$'

Ezt kell látnod: The cosign claims were validated. Minden más azt jelenti, hogy az image nem a HolyArrs kiadási folyamatából jött: ne futtasd.

Az image tartalmaz egy feljegyzést az elkészítéséről és egy listát arról, mi van benne (SBOM). Ezeket a GitHub CLI-vel ellenőrizheted:

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

Ugyanezek a fájlok minden GitHub release oldalán megtalálhatók: .sigstore.json (aláírás), .intoto.jsonl (build-feljegyzés) és .sbom.spdx.json (tartalom).

Kapcsolódó oldalak

• Backupok
• Állapotellenőrzések
• Részek és biztonságos mód