Aktualizácie

HolyArrs ti povie, keď vyjde nová verzia, a nikdy ju sám nenainštaluje. Nový image si stiahneš, keď ti to vyhovuje.

Zisti, či vyšla nová verzia

1. Otvor stránku Status (stav) (http://your-server:6262/health).
2. Prečítaj si Updates (aktualizácie). Mal by si vidieť jednu z týchto správ:

Správa	Význam
“HolyArrs 1.2.0 is out, newer than this one.” (Vyšiel HolyArrs 1.2.0, novší ako tento.)	Aktualizuj, keď budeš chcieť
“This is the newest version.” (Toto je najnovšia verzia.)	Nič netreba robiť
“No HolyArrs release is published yet.” (Zatiaľ nie je zverejnená žiadna verzia HolyArrs.)	Feed je prázdny. Nič nie je zle
“The last check did not work: …” (Posledná kontrola nefungovala: …)	Feed sa nepodarilo dosiahnuť, väčšinou chýba internet
“The update check is off: …” (Kontrola aktualizácií je vypnutá: …)	Vypnuté v nastaveniach

3. Ak sa chceš opýtať hneď, klikni na Check now (skontrolovať teraz) (alebo Check again (skontrolovať znova)). Potrebuješ oprávnenie Change settings (meniť nastavenia).

Novšia verzia sa zobrazí aj ako varovanie v kontrole stavu. Neúspešná kontrola sa ukáže iba pod Updates.

Aktualizuj

1. Stiahni nový image a reštartuj: docker compose pull, potom docker compose up -d.
2. HolyArrs sa spustí. Ak nová verzia mení spôsob ukladania dát, najprv urobí zálohu a potom dáta aktualizuje. Mal by si vidieť, že sa aplikácia otvorí v novej verzii.

Tip

Neúspešný krok aktualizácie sa vráti späť a HolyArrs sa zastaví na stránke, ktorá povie, čo sa stalo. Tvoje dáta spred aktualizácie ostanú ako záloha.

Vráť sa na staršiu verziu

HolyArrs nevie zmeniť vlastný image, takže spustíš starší image a HolyArrs vráti staršie dáta.

Upozornenie

Všetko, čo sa zmenilo po aktualizácii, napríklad nové tituly, nastavenia a história, nie je v zálohe spred aktualizácie.

1. V compose súbore (alebo v docker run) zmeň tag image na starší, napríklad holyarrs/holyarrs:<older version>.
2. Spusti docker compose up -d.
3. Ak aktualizácia dáta nezmenila, spustí sa staršia verzia. Hotovo.
4. Inak staršia verzia namiesto aplikácie ukáže stránku. Klikni na Put back the data from before the update (vrátiť dáta spred aktualizácie).
5. Zadaj jednorazový kód. Nájdeš ho cez docker logs <container>; hľadaj „one-time code“.
6. HolyArrs skontroluje zálohu, vloží ju na miesto a zastaví sa. Mal by si vidieť, že kontajner sa na týchto dátach znova spustí cez svoju politiku reštartu. Bez nej ho spusti sám.

Bez stránky: docker exec <container> /holyarrs restore --pre-update, potom docker restart <container>. Bez Dockeru: zastav HolyArrs, spusti holyarrs restore --pre-update a spusti ho znova.

Nič sa nemaže. Novšie dáta sa presunú do backups/before-restore-<time>/, takže to môžeš vrátiť. Pri návrate o viac než jednu verziu sa vyberie najnovšia záloha spred aktualizácie, ktorú tá verzia vie čítať.

Možnosti

Všetko je v Settings > Health checks. Posledné tri sú v rozšírenej časti karty.

Nastavenie	Predvolene	Zmeň, keď
Check for a newer HolyArrs (kontrolovať novší HolyArrs)	On (zapnuté)	Nechceš žiadnu požiadavku von
Check for updates every (kontrolovať aktualizácie každých)	deň	Chceš menej kontrol: 3, 7, 14 alebo 30 dní
Release feed (feed verzií)	Prázdne (verzie HolyArrs)	Hostuješ vlastný feed
Feed may be on the local network (feed môže byť v lokálnej sieti)	Off (vypnuté)	Tvoj feed je vo vlastnej sieti
Include test versions (like 1.2.0-rc1) (zahrnúť testovacie verzie)	Off (vypnuté)	Chceš upozornenia na testovacie verzie

Ak to nefunguje

Príznak: „The last check did not work.“ Príčina: server nemá internet, alebo je tvoj vlastný feed v lokálnej sieti. Riešenie: skontroluj prístup na internet, alebo zapni Feed may be on the local network.

Príznak: feed verzií sa neuloží. Príčina: adresa obsahuje meno, heslo, ?query alebo #fragment, alebo nezačína http:// či https://. Riešenie: odstráň tieto časti.

Príznak: aktualizácia sa zastavila pre nedostatok miesta na disku. Príčina: nie je miesto na kópiu a aktualizáciu. Riešenie: uvoľni miesto tam, kde je konfiguračný priečinok, a spusti znova.

Príznak: stránka na návrat odmieta tvoj kód. Príčina: starý kód, alebo 10 nesprávnych kódov od posledného spustenia. Riešenie: skopíruj kód z najnovšieho riadka logu. Po 10 nesprávnych pokusoch reštartuj kontajner a použi nový kód.

Pozdržané funkcie

Niektoré funkcie sú v tejto verzii predvolene vypnuté. Zapni ich na vlastné riziko. Kým sú pozdržané, ich stránky a položky menu sú skryté, ich trasy API odpovedajú „not found“ a ich úlohy nebežia. Dáta, ktoré si pre ne uložil, ostanú.

Ak chceš niektorú zapnúť, pridaj jej prepínač do HOLYARRS_FLAGS, oddelený čiarkou, a reštartuj kontajner:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Ak chceš funkciu vypnúť, odstráň názov a reštartuj. Skryté nastavenia sa vrátia, keď ju znova zapneš.

Prepínač	Funkcia
row_title_stats	Štatistiky titulov v riadkoch Explore v Appearance
trakt_lists	Kľúč Trakt, zoznamy Trakt a recenzie Trakt. Zoznamy TMDB ostávajú zapnuté
alert_channels_more	Upozornenia cez Telegram, ntfy, Gotify, Pushover a webhook. Discord a e-mail ostávajú zapnuté
subtitle_sites	Stránky s titulkami a hľadanie titulkov. Jazyk tvojich titulkov ostáva zapnutý
emby_signin	Prihlásenie cez Emby. Obnova knižnice Emby stále funguje
go_back	Panel Go back na stránke Status. Kroky v Vráť sa na staršiu verziu fungujú aj bez neho

Po pridaní prepínača sa nič nezmenilo? Skontroluj pravopis (malé písmená, podčiarkovníky) a reštartuj kontajner, nielen stránku.

Pre expertov

Čo kontrola posiela

Jedna požiadavka na api.github.com o najnovšiu verziu, len s User-Agent: HolyArrs/<version>. Žiadny účet, kľúč ani zoznam médií. Pri vypnutej kontrole žiadna požiadavka.

Posledná odpoveď sa uloží, takže reštart nekontroluje skôr, ako je potrebné. Jedna kontrola čaká najviac 15 s, číta najviac 512 KB a nasleduje najviac 3 presmerovania, nikdy nepreskakuje medzi http a https. Odkaz na poznámky k vydaniu sa zobrazí, iba ak vedie na stránky verzií HolyArrs na GitHube; inak sa verzia zobrazí ako obyčajný text.

Release feed prijíma odpoveď v štýle GitHubu, zoznam verzií, akýkoľvek JSON s version alebo obyčajný text s verziou. Adresy cloudových metadát sa vždy odmietnu. Testovacia verzia sa počíta ako staršia než obyčajná verzia.

Záloha pred aktualizáciou

Pred zmenou uložených dát HolyArrs:

1. Skontroluje, či je miesto na kópiu a aktualizáciu. Ak nie, nič sa nezmení. Preskočíš to cez HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Skopíruje každú databázu do backups, skontroluje kópiu a vedľa nej zapíše súbor sha256. Po 3 neúspešných kópiách sa nič nezmení.
3. Spustí každý krok aktualizácie osobitne a skontroluje ho. Neúspešný krok sa vráti späť; dokončené kroky ostanú. Spusti tú istú verziu znova a pokračuje sa od neúspešného kroku s tou istou kópiou.

Po prvom úspešnom spustení sa kópia stane holyarrs-backup-pre-update-<time>.zip s popisom ako „before updating from 1.1.0 to 1.2.0“. Zobrazí sa v Settings > Backups a v holyarrs restore --list. Ostávajú najnovšie 3; plán záloh ich nikdy neodstráni. Čistá inštalácia alebo aktualizácia, ktorá dáta nemení, žiadnu nevytvorí.

Over image

Od 1.0.3 je každý image na Docker Hub podpísaný pri vydaní na GitHube. Nie je potrebné sťahovať žiadny kľúč. Image over cez cosign. Verziu, ktorú používaš, napríklad 1.0.3, dosaď tam, kde je <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)$'

Mal by si vidieť The cosign claims were validated. Čokoľvek iné znamená, že image nepochádza z vydávacieho procesu HolyArrs: nespúšťaj ho.

Image má aj záznam o tom, ako vznikol, a zoznam toho, čo obsahuje (SBOM). Over ich cez GitHub CLI:

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

Rovnaké súbory sú pri každom vydaní na GitHube: .sigstore.json (podpis), .intoto.jsonl (záznam o zostavení) a .sbom.spdx.json (obsah).

Súvisiace stránky

• Zálohy
• Kontroly stavu
• Časti a núdzový režim