Updates

HolyArrs meldt je wanneer er een nieuwe versie is en installeert die nooit zelf. Jij haalt de nieuwe image op wanneer het jou uitkomt.

Zien of er een nieuwe versie is

1. Open de pagina Status (http://your-server:6262/health).
2. Lees Updates. Je ziet een van deze meldingen:

Bericht	Betekenis
“HolyArrs 1.2.0 is out, newer than this one.”	Update wanneer je er klaar voor bent
“This is the newest version.”	Je hoeft niets te doen
“No HolyArrs release is published yet.”	De feed is leeg. Er is niets mis
“The last check did not work: …”	De feed is niet bereikt, vaak door ontbrekend internet
“The update check is off: …”	Uitgezet in de instellingen

3. Wil je direct controleren, klik dan op Check now (nu controleren) of Check again (opnieuw controleren). Hiervoor heb je het recht Change settings (instellingen wijzigen) nodig.

Een nieuwere versie verschijnt ook als waarschuwing bij de gezondheidscontroles. Een mislukte controle zie je alleen onder Updates.

Updaten

1. Haal de nieuwe image op en herstart: docker compose pull, daarna docker compose up -d.
2. HolyArrs start. Verandert de nieuwe versie hoe gegevens worden opgeslagen, dan maakt HolyArrs eerst een backup en werkt daarna de gegevens bij. Je ziet de app openen op de nieuwe versie.

Tip

Mislukt een updatestap, dan wordt die ongedaan gemaakt en stopt HolyArrs op een pagina die zegt wat er gebeurd is. Je gegevens van vóór de update blijven als backup bewaard.

Teruggaan naar de vorige versie

HolyArrs kan zijn eigen image niet wijzigen. Jij draait dus de oudere image en HolyArrs zet de oudere gegevens terug.

Opgepast

Alles wat je na de update hebt gewijzigd, zoals nieuwe titels, instellingen en geschiedenis, zit niet in de backup van vóór de update.

1. Verander de image-tag in je Compose-bestand (of docker run) naar de oudere, bijvoorbeeld holyarrs/holyarrs:<older version>.
2. Voer docker compose up -d uit.
3. Heeft de update de gegevens niet veranderd, dan start de oudere versie. Je bent klaar.
4. Anders toont de oudere versie een pagina in plaats van de app. Klik op Put back the data from before the update (de gegevens van vóór de update terugzetten).
5. Typ de eenmalige code. Je vindt die met docker logs <container>; zoek naar “one-time code”.
6. HolyArrs controleert de backup, zet hem terug en stopt. Je ziet de container via het herstartbeleid weer starten op die gegevens. Heb je geen herstartbeleid, start de container dan zelf.

Zonder de pagina: docker exec <container> /holyarrs restore --pre-update, daarna docker restart <container>. Zonder Docker: stop HolyArrs, voer holyarrs restore --pre-update uit en start het weer.

Er wordt niets verwijderd. De nieuwere gegevens gaan naar backups/before-restore-<time>/, zodat je het kunt terugdraaien. Ga je meer dan één versie terug, dan kiest HolyArrs de nieuwste backup van vóór een update die die versie kan lezen.

Keuzes

Alles staat onder Settings > Health checks (instellingen > gezondheidscontroles). De laatste drie zitten onder het geavanceerde deel van de kaart.

Instelling	Standaard	Wijzig het als
Check for a newer HolyArrs (op een nieuwere HolyArrs controleren)	Aan	Je helemaal geen verzoek naar buiten wilt
Check for updates every (controleren op updates elke)	dag	Je minder vaak wilt controleren: 3, 7, 14 of 30 dagen
Release feed (releasefeed)	Leeg (HolyArrs-versies)	Je zelf een feed host
Feed may be on the local network (feed mag op het lokale netwerk staan)	Uit	Je feed op je eigen netwerk staat
Include test versions (like 1.2.0-rc1) (testversies meenemen)	Uit	Je meldingen over testversies wilt

Als het niet werkt

Symptoom: “The last check did not work.” Oorzaak: de server heeft geen internet, of je eigen feed staat op het lokale netwerk. Oplossing: controleer de internettoegang, of zet Feed may be on the local network aan.

Symptoom: de releasefeed wil niet opslaan. Oorzaak: het adres bevat een naam, wachtwoord, ?query of #fragment, of begint niet met http:// of https://. Oplossing: haal die delen weg.

Symptoom: de update stopte door te weinig schijfruimte. Oorzaak: er is geen plek voor de kopie en de update. Oplossing: maak ruimte vrij waar de configuratiemap staat en start opnieuw.

Symptoom: de pagina om terug te gaan weigert je code. Oorzaak: een oude code, of 10 foute codes sinds de laatste start. Oplossing: kopieer de code uit de nieuwste logregel. Herstart de container na 10 foute pogingen en gebruik de nieuwe code.

Uitgestelde functies

Sommige functies staan in deze versie standaard uit. Zet ze aan op eigen risico. Zolang ze uitgesteld zijn, zijn hun pagina’s en menu-items verborgen, antwoorden hun API-routes met “not found” en draaien hun taken niet. Gegevens die je ervoor hebt opgeslagen, blijven bewaard.

Om er een aan te zetten, voeg je de schakelaar toe aan HOLYARRS_FLAGS, gescheiden door komma’s, en herstart je de container:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Haal de naam weg en herstart om de functie weer uit te zetten. Verborgen instellingen komen terug zodra je hem opnieuw aanzet.

Schakelaar	Functie
plex_watchlists	Plex-watchlists worden aanvragen
row_title_stats	Titelstatistieken in Ontdekken-rijen onder Appearance
trakt_lists	Trakt-sleutel, Trakt-lijsten en Trakt-recensies. TMDB-lijsten blijven aan
alert_channels_more	Meldingen via Telegram, ntfy, Gotify, Pushover en webhook. Discord en e-mail blijven aan
subtitle_sites	Ondertitelsites en zoeken naar ondertitels. Je ondertiteltaal blijft aan
emby_signin	Aanmelden met Emby. Het vernieuwen van de Emby-bibliotheek werkt nog
go_back	Het paneel Go back (teruggaan) op de Statuspagina. De stappen onder Teruggaan naar de vorige versie werken ook zonder

Is er niets veranderd na het toevoegen van een schakelaar? Controleer de spelling (kleine letters, underscores) en herstart de container, niet alleen de pagina.

Voor gevorderden

Wat de controle verstuurt

Eén verzoek naar api.github.com voor de nieuwste versie, met alleen User-Agent: HolyArrs/<version>. Geen account, sleutel of medialijst. Staat de controle uit, dan is er helemaal geen verzoek.

Het laatste antwoord wordt bewaard, dus een herstart controleert niet voordat het tijd is. Een controle wacht hooguit 15 s, leest hooguit 512 KB en volgt hooguit 3 doorverwijzingen, zonder ooit te wisselen tussen http en https. Een link naar de release-opmerkingen verschijnt alleen als die naar de HolyArrs-releasepagina’s op GitHub wijst; anders staat de versie als gewone tekst.

Release feed accepteert een release-antwoord in GitHub-stijl, een lijst van releases, elke JSON met version, of platte tekst met de versie. Adressen van cloud-metadata worden altijd geweigerd. Een testversie telt als ouder dan de gewone versie.

De backup vóór een update

Voordat HolyArrs opgeslagen gegevens verandert:

1. Controleert het of er ruimte is voor een kopie en de update. Zo niet, dan verandert er niets. Sla dit over met HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Kopieert het elke database naar backups, controleert de kopie en schrijft er een sha256-bestand naast. Na 3 mislukte kopieën verandert er niets.
3. Voert het elke updatestap apart uit en controleert die. Een mislukte stap wordt ongedaan gemaakt; voltooide stappen blijven. Start dezelfde versie opnieuw om bij de mislukte stap verder te gaan met dezelfde kopie.

Na de eerste goede start wordt de kopie holyarrs-backup-pre-update-<time>.zip, met een beschrijving als “before updating from 1.1.0 to 1.2.0”. Je ziet hem in Settings > Backups en bij holyarrs restore --list. De nieuwste 3 blijven bewaard; het backupschema verwijdert ze nooit. Een verse installatie of een update die de gegevens ongemoeid laat, maakt er geen.

Gerelateerde pagina’s

• Backups
• Gezondheidscontroles
• Onderdelen en veilige modus