Uppdateringar

HolyArrs berättar när en ny version finns, men installerar den aldrig själv. Du hämtar den nya imagen när det passar dig.

Se om en ny version finns

1. Öppna sidan Status (http://your-server:6262/health).
2. Läs under Updates (uppdateringar). Du ska se ett av dessa meddelanden:

Meddelande	Betydelse
“HolyArrs 1.2.0 is out, newer than this one.”	Uppdatera när du är redo
“This is the newest version.”	Inget att göra
“No HolyArrs release is published yet.”	Flödet är tomt. Inget är fel
“The last check did not work: …”	Flödet nåddes inte, ofta för att internet saknas
“The update check is off: …”	Avstängd i inställningarna

3. Om du vill fråga direkt klickar du på Check now (kontrollera nu) eller Check again (kontrollera igen). Det kräver behörigheten Change settings (ändra inställningar).

En nyare version visas också som en hälsovarning. En misslyckad kontroll syns bara under Updates.

Uppdatera

1. Hämta den nya imagen och starta om: docker compose pull och sedan docker compose up -d.
2. HolyArrs startar. Om den nya versionen ändrar hur data lagras gör den först en backup och uppdaterar sedan datan. Du ska se appen öppnas på den nya versionen.

Tip

Ett uppdateringssteg som misslyckas ångras, och HolyArrs stannar på en sida som berättar vad som hände. Din data från före uppdateringen finns kvar som backup.

Gå tillbaka till den äldre versionen

HolyArrs kan inte byta sin egen image, så du kör den äldre imagen och HolyArrs lägger tillbaka den äldre datan.

Caution

Allt som ändrats efter uppdateringen, som nya titlar, inställningar och historik, finns inte i backupen från före uppdateringen.

1. Ändra image-taggen i din Compose-fil (eller docker run) till den äldre, till exempel holyarrs/holyarrs:<older version>.
2. Kör docker compose up -d.
3. Om uppdateringen inte ändrade datan startar den äldre versionen. Då är du klar.
4. Annars visar den äldre versionen en sida i stället för appen. Klicka på Put back the data from before the update (lägg tillbaka datan från före uppdateringen).
5. Skriv engångskoden. Du hittar den med docker logs <container>; leta efter “one-time code”.
6. HolyArrs kontrollerar backupen, lägger den på plats och stannar. Du ska se containern starta igen på den datan via sin omstartspolicy. Utan en sådan startar du den själv.

Utan sidan: docker exec <container> /holyarrs restore --pre-update, sedan docker restart <container>. Utan Docker: stoppa HolyArrs, kör holyarrs restore --pre-update och starta det.

Inget raderas. Den nyare datan flyttas till backups/before-restore-<time>/, så du kan ångra dig. Om du går tillbaka mer än en version väljs den senaste backupen från före en uppdatering som den versionen kan läsa.

Val

Allt finns i Settings > Health checks. De tre sista ligger under kortets avancerade del.

Inställning	Standard	Ändra den när
Check for a newer HolyArrs (leta efter en nyare HolyArrs)	På	Du inte vill ha någon utgående förfrågan alls
Check for updates every (leta efter uppdateringar var)	dag	Du vill ha färre kontroller: 3, 7, 14 eller 30 dagar
Release feed (versionsflöde)	Tomt (HolyArrs-versioner)	Du har ett eget flöde
Feed may be on the local network (flödet får ligga på det lokala nätverket)	Av	Ditt flöde ligger på ditt eget nätverk
Include test versions (like 1.2.0-rc1) (ta med testversioner)	Av	Du vill ha besked om testversioner

Om det inte fungerar

Symptom: “The last check did not work.” Orsak: servern har inget internet, eller ditt eget flöde ligger på det lokala nätverket. Lösning: kontrollera internetåtkomsten eller slå på Feed may be on the local network.

Symptom: versionsflödet går inte att spara. Orsak: adressen innehåller ett namn, ett lösenord, ?query eller #fragment, eller börjar inte med http:// eller https://. Lösning: ta bort de delarna.

Symptom: uppdateringen stoppades på grund av för lite diskutrymme. Orsak: det finns inte plats för kopian och uppdateringen. Lösning: frigör utrymme där konfigurationsmappen ligger och starta sedan igen.

Symptom: sidan för att gå tillbaka nekar din kod. Orsak: en gammal kod, eller 10 felaktiga koder sedan senaste start. Lösning: kopiera koden från den nyaste loggraden. Efter 10 felaktiga försök startar du om containern och använder den nya koden.

Uppskjutna funktioner

Vissa funktioner är avstängda som standard i den här versionen. Slå på dem på egen risk. Medan de är uppskjutna är deras sidor och menyval dolda, deras API-routes svarar “not found” och deras jobb körs inte. Data du har sparat för dem finns kvar.

Du slår på en genom att lägga till dess reglage i HOLYARRS_FLAGS, kommaseparerat, och starta om containern:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Ta bort namnet och starta om för att slå av den. Dolda inställningar kommer tillbaka när du slår på den igen.

Reglage	Funktion
row_title_stats	Titelstatistik för Utforska-rader i Appearance
trakt_lists	Trakt-nyckel, Trakt-listor och Trakt-recensioner. TMDB-listor förblir på
alert_channels_more	Aviseringar via Telegram, ntfy, Gotify, Pushover och webhook. Discord och e-post förblir på
subtitle_sites	Undertextsidor och undertextsökning. Ditt undertextspråk förblir på
emby_signin	Logga in med Emby. Uppdatering av Emby-biblioteket fungerar fortfarande
go_back	Panelen Go back (gå tillbaka) på Status-sidan. Stegen i Gå tillbaka fungerar utan den

Hände ingenting när du lade till ett reglage? Kontrollera stavningen (gemener, understreck) och starta om containern, inte bara sidan.

För experter

Vad kontrollen skickar

En förfrågan till api.github.com om den nyaste versionen, med bara User-Agent: HolyArrs/<version>. Inget konto, ingen nyckel och ingen medialista. När kontrollen är av skickas ingen förfrågan alls.

Det senaste svaret sparas, så en omstart kontrollerar inte innan det är dags. En kontroll väntar högst 15 s, läser högst 512 KB och följer högst 3 omdirigeringar, aldrig mellan http och https. En länk till versionsanteckningar visas bara när den pekar till HolyArrs versionssidor på GitHub. Annars visas versionen som vanlig text.

Release feed godtar ett svar i GitHub-stil, en lista med versioner, valfri JSON med version, eller ren text som innehåller versionen. Adresser till molnmetadata nekas alltid. En testversion räknas som äldre än den vanliga versionen.

Backupen före en uppdatering

Innan lagrad data ändras gör HolyArrs så här:

1. Kontrollerar att det finns plats för en kopia och uppdateringen. Annars ändras ingenting. Hoppa över med HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Kopierar varje databas till backups, kontrollerar kopian och skriver en sha256-fil bredvid. Efter 3 misslyckade kopieringar ändras ingenting.
3. Kör varje uppdateringssteg för sig och kontrollerar det. Ett steg som misslyckas ångras. Färdiga steg blir kvar. Starta samma version igen för att fortsätta från det misslyckade steget med samma kopia.

Efter första lyckade start blir kopian holyarrs-backup-pre-update-<time>.zip, beskriven som “before updating from 1.1.0 to 1.2.0”. Den syns i Settings > Backups och i holyarrs restore --list. De 3 nyaste sparas. Backupschemat tar aldrig bort dem. En nyinstallation, eller en uppdatering som lämnar datan orörd, gör ingen.

Verifiera imagen

Från 1.0.3 är varje image på Docker Hub signerad av versionsjobbet på GitHub. Ingen nyckel behöver laddas ner. Kontrollera en image med cosign. Skriv versionen du kör, som 1.0.3, där det står <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)$'

Du ska se The cosign claims were validated. Allt annat betyder att imagen inte kommer från HolyArrs versionsjobb: kör den inte.

Imagen innehåller också en beskrivning av hur den byggdes och en lista över vad som finns i den (en SBOM). Kontrollera dem med GitHub CLI:

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

Samma filer finns på varje GitHub-version: .sigstore.json (signatur), .intoto.jsonl (byggbeskrivning) och .sbom.spdx.json (innehåll).

Relaterat

• Backuper
• Hälsokontroller
• Delar och felsäkert läge