Actualizări

HolyArrs îți spune când apare o versiune nouă și nu o instalează niciodată singur. Tragi imaginea nouă când îți convine.

Vezi dacă a apărut o versiune nouă

1. Deschide pagina Status (Stare) (http://your-server:6262/health).
2. Citește Updates (actualizări). Ar trebui să vezi unul dintre mesajele astea:

Mesaj	Ce înseamnă
“HolyArrs 1.2.0 is out, newer than this one.”	Actualizează când ești gata
“This is the newest version.”	Nu ai nimic de făcut
“No HolyArrs release is published yet.”	Feed-ul e gol. Nu e nimic în neregulă
“The last check did not work: …”	Feed-ul nu a putut fi contactat, de obicei lipsește internetul
“The update check is off: …”	Oprită în Settings (Setări)

3. Ca să întrebi acum, apasă Check now (verifică acum) sau Check again (verifică din nou). Ai nevoie de permisiunea Change settings (schimbă setările).

O versiune mai nouă apare și ca avertisment de sănătate. O verificare eșuată apare doar la Updates.

Actualizează

1. Trage imaginea nouă și repornește: docker compose pull, apoi docker compose up -d.
2. HolyArrs pornește. Dacă versiunea nouă schimbă felul în care sunt stocate datele, face mai întâi o copie de rezervă, apoi actualizează datele. Ar trebui să vezi aplicația deschizându-se pe versiunea nouă.

Sfat

Un pas de actualizare eșuat este anulat, iar HolyArrs se oprește pe o pagină care spune ce s-a întâmplat. Datele tale de dinainte de actualizare rămân ca o copie de rezervă.

Revino la versiunea veche

HolyArrs nu își poate schimba singur imaginea, așa că rulezi imaginea veche, iar HolyArrs readuce datele vechi.

Atenție

Tot ce s-a schimbat după actualizare, cum ar fi titluri noi, setări și istoric, nu e în copia de rezervă de dinainte de actualizare.

1. Schimbă eticheta imaginii din fișierul tău compose (sau din docker run) cu cea veche, de exemplu holyarrs/holyarrs:<older version>.
2. Rulează docker compose up -d.
3. Dacă actualizarea nu a schimbat datele, pornește versiunea veche. Ai terminat.
4. Altfel, versiunea veche arată o pagină în locul aplicației. Apasă Put back the data from before the update (readu datele de dinainte de actualizare).
5. Scrie codul de unică folosință. Îl găsești cu docker logs <container>; caută “one-time code”.
6. HolyArrs verifică copia de rezervă, o pune la loc și se oprește. Ar trebui să vezi containerul pornind din nou pe acele date prin politica lui de repornire. Fără ea, pornește-l tu.

Fără pagină: docker exec <container> /holyarrs restore --pre-update, apoi docker restart <container>. Fără Docker: oprește HolyArrs, rulează holyarrs restore --pre-update, pornește-l.

Nu se șterge nimic. Datele mai noi se mută în backups/before-restore-<time>/, deci poți anula. Dacă revii cu mai mult de o versiune, se alege cea mai nouă copie de dinainte de actualizare pe care o poate citi acea versiune.

Alegeri

Toate sunt în Settings > Health checks (Setări > Verificări de sănătate). Ultimele trei sunt în partea avansată a cardului.

Setare	Implicit	Schimb-o când
Check for a newer HolyArrs (verifică dacă există un HolyArrs mai nou)	On (pornit)	Nu vrei nicio cerere în afară
Check for updates every (verifică actualizările la fiecare)	zi	Vrei mai puține verificări: 3, 7, 14 sau 30 de zile
Release feed (feed de versiuni)	Gol (versiunile HolyArrs)	Îți găzduiești propriul feed
Feed may be on the local network (feed-ul poate fi în rețeaua locală)	Off (oprit)	Feed-ul tău e în propria rețea
Include test versions (like 1.2.0-rc1) (include versiuni de test)	Off (oprit)	Vrei să primești anunțuri pentru versiuni de test

Dacă nu merge

Simptom: “The last check did not work.” Cauză: serverul nu are internet, sau propriul tău feed e în rețeaua locală. Soluție: verifică accesul la internet sau pornește Feed may be on the local network.

Simptom: feed-ul de versiuni nu se salvează. Cauză: adresa conține un nume, o parolă, ?query sau #fragment, ori nu începe cu http:// sau https://. Soluție: scoate acele părți.

Simptom: actualizarea s-a oprit din lipsă de spațiu pe disc. Cauză: nu e loc pentru copie și pentru actualizare. Soluție: eliberează spațiu unde se află dosarul de configurare, apoi pornește din nou.

Simptom: pagina de revenire refuză codul tău. Cauză: un cod vechi, sau 10 coduri greșite de la ultima pornire. Soluție: copiază codul din cea mai nouă linie a jurnalului (log). După 10 încercări greșite, repornește containerul și folosește codul nou.

Funcții reținute

Unele funcții sunt oprite implicit în această versiune. Le pornești pe riscul tău. Cât sunt reținute, paginile și elementele lor din meniu sunt ascunse, rutele lor API răspund “not found”, iar sarcinile lor nu rulează. Datele pe care le-ai salvat pentru ele rămân.

Ca să pornești una, adaugă comutatorul ei în HOLYARRS_FLAGS, separat prin virgulă, și repornește containerul:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Scoate numele și repornește ca s-o oprești. Setările ascunse revin când o pornești din nou.

Comutator	Funcție
row_title_stats	Statistici pe titluri în rândurile din Explore, la Appearance
trakt_lists	Cheie Trakt, liste Trakt și recenzii Trakt. Listele TMDB rămân pornite
alert_channels_more	Alerte pe Telegram, ntfy, Gotify, Pushover și webhook. Discord și email rămân pornite
subtitle_sites	Site-uri de subtitrări și căutare de subtitrări. Limba ta de subtitrare rămâne pornită
emby_signin	Conectare cu Emby. Reîmprospătarea bibliotecii Emby merge în continuare
go_back	Panoul Go back de pe pagina Status. Pașii din Revino la versiunea veche merg și fără el

Nu s-a schimbat nimic după ce ai adăugat un comutator? Verifică scrierea (litere mici, liniuțe jos) și repornește containerul, nu doar pagina.

Pentru experți

Ce trimite verificarea

O singură cerere către api.github.com pentru cea mai nouă versiune, cu doar User-Agent: HolyArrs/<version>. Fără cont, cheie sau listă de media. Cu verificarea oprită, nu se trimite nicio cerere.

Ultimul răspuns e salvat, așa că o repornire nu verifică înainte de vreme. O verificare așteaptă cel mult 15 s, citește cel mult 512 KB și urmează cel mult 3 redirecționări, fără să treacă vreodată între http și https. Un link către notele versiunii apare doar când duce la paginile de versiuni HolyArrs de pe GitHub; altfel versiunea apare ca text simplu.

Release feed acceptă un răspuns de versiune în stil GitHub, o listă de versiuni, orice JSON cu version sau text simplu care conține versiunea. Adresele de metadate cloud sunt mereu refuzate. O versiune de test contează ca mai veche decât versiunea simplă.

Copia de rezervă de dinainte de o actualizare

Înainte să schimbe datele stocate, HolyArrs:

1. Verifică dacă e loc pentru o copie și pentru actualizare. Dacă nu, nu se schimbă nimic. Sari peste verificare cu HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Copiază fiecare bază de date în backups, verifică copia și scrie lângă ea un fișier sha256. După 3 copieri eșuate, nu se schimbă nimic.
3. Rulează fiecare pas de actualizare separat și îl verifică. Un pas eșuat este anulat; pașii terminați rămân. Pornește aceeași versiune din nou ca să continui de la pasul eșuat cu aceeași copie.

După prima pornire reușită, copia devine holyarrs-backup-pre-update-<time>.zip, descrisă ca “before updating from 1.1.0 to 1.2.0”. Apare în Settings > Backups și în holyarrs restore --list. Se păstrează ultimele 3; programul de copii de rezervă nu le șterge niciodată. O instalare nouă sau o actualizare care nu atinge datele nu face nicio copie.

Verifică imaginea

Începând cu 1.0.3, fiecare imagine de pe Docker Hub e semnată de procesul de publicare de pe GitHub. Nu ai nicio cheie de descărcat. Verifică o imagine cu cosign. Pune versiunea pe care o rulezi, cum ar fi 1.0.3, unde scrie <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)$'

Ar trebui să vezi The cosign claims were validated. Orice altceva înseamnă că imaginea nu vine de la procesul de publicare HolyArrs: nu o rula.

Imaginea mai are și o evidență a felului în care a fost construită și o listă cu ce conține (un SBOM). Verifică-le cu GitHub CLI:

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

Aceleași fișiere sunt la fiecare versiune de pe GitHub: .sigstore.json (semnătura), .intoto.jsonl (evidența construirii) și .sbom.spdx.json (conținutul).

Vezi și

• Copii de rezervă
• Verificări de sănătate
• Părți și mod sigur