Backups

Bewaar een kopie van je configuratie, zodat je die kunt terugzetten na een mislukte update, een kapotte schijf of een verhuizing naar een nieuwe computer.

Voor je begint

• Settings > Backups (Instellingen > Backups) vraagt de rechten Change settings (instellingen wijzigen). Alleen de eigenaar zet een backup terug.
• Downloaden, verwijderen en terugzetten vragen een aanmelding met wachtwoord van de afgelopen minuten.

Een backup maken

1. Open Settings > Backups.
2. Klik op Back up now (nu een backup maken). De nieuwe backup staat nu onder Saved backups (bewaarde backups).
3. Klik naast de backup op Download (downloaden) om een kopie buiten de server te bewaren.

De hoofdsleutel bewaren

Backups bevatten de hoofdsleutel nooit. Die opent de wachtwoorden en API-sleutels in je instellingen. Zonder de bijbehorende sleutel kan een teruggezette backup ze niet lezen.

1. Onder Master key (hoofdsleutel) klikt de eigenaar op Download key kit (sleutelpakket downloaden).
2. Bewaar het bestand niet op de server en apart van je backups. De waarschuwing over het sleutelpakket verdwijnt nu uit Settings > Backups en uit de gezondheidscontroles.

Wil je het later gebruiken, hernoem het dan naar holyarrs.key en zet het in de configuratiemap. Ben je niet de eigenaar? Vraag de eigenaar om het te downloaden.

Een backup terugzetten

Gevaar

Wijzigingen sinds de backup gaan verloren. Zorg eerst dat je de bijbehorende hoofdsleutel hebt.

1. Klik op Restore from a file (terugzetten vanuit een bestand) en kies een HolyArrs-backup als zip.
2. Bevestig.
3. HolyArrs controleert het bestand. Je ziet nu Restore ready. It applies on the next start. (Terugzetten staat klaar. Het wordt bij de volgende start toegepast.)
4. HolyArrs herstart en zet de backup op zijn plek. Met het aanbevolen herstartbeleid van Docker gebeurt dit vanzelf.

Je huidige databases gaan naar /config/backups/before-restore-<time>, zodat je het terugzetten ongedaan kunt maken.

Keuzes

Hoe vaak

Keuze	Maakt een backup	Bewaart
Balanced (gebalanceerd, standaard)	Elke dag	De laatste 7 dagen en 4 wekelijkse kopieën
Light (licht)	Eén keer per week	4 weken. Neemt de minste ruimte in
Careful (zorgvuldig)	Elke dag	Elke kopie 30 dagen

De nieuwste geplande backup blijft altijd bewaard. Deze regels ruimen alleen geplande backups op. Backups die je zelf maakt blijven staan tot je ze verwijdert (prullenbakknop op de rij; dit kan niet ongedaan worden gemaakt). HolyArrs maakt ook een backup vóór een update die opgeslagen gegevens wijzigt en bewaart de nieuwste 3; zie Updates.

Overstappen naar een nieuwe computer

Een nieuwe installatie maakt bij de eerste start een eigen hoofdsleutel. Die sleutel kan je oude backups niet openen, dus het terugzetten wordt geweigerd. Zet eerst de oude sleutel op zijn plek. In de voorbeelden heet de container holyarrs; gebruik je eigen naam.

1. Maak vóór de eerste start de container aan zonder hem te starten: docker compose create, of je docker run-regel met docker create in plaats van docker run -d.
2. Kopieer je oude sleutel erin: docker cp holyarrs.key holyarrs:/config/. Een sleutelpakket dat je hernoemt naar holyarrs.key werkt ook. Dit werkt voor een benoemd volume of een hostmap; HolyArrs geeft de bestanden in /config bij het starten aan jouw PUID en PGID. Gebruik je HOLYARRS_MASTER_KEY_FILE, zet de sleutel dan op die plek op de host, leesbaar voor jouw PUID en PGID.
3. Zet de backup terug. Kies een van deze manieren:

   • Start HolyArrs, rond de eerste start af en gebruik dan Restore from a file in Settings > Backups.

   • Of zet terug vóór de eerste start. Zet de zip, met ongewijzigde naam, in een map met de naam backups en kopieer die erin met docker cp backups holyarrs:/config/. Voer daarna het terugzetten eenmalig uit met dezelfde image:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Heb je een pad naar een sleutelbestand, voeg dan -e HOLYARRS_MASTER_KEY_FILE=<its path> toe, zodat het terugzetten met jouw sleutel controleert. restore --list toont de namen van de backups die het ziet.

4. Start HolyArrs. Je ziet nu je bibliotheek en instellingen terug.

Heb je de nieuwe installatie gestart voordat je de sleutel kopieerde? Staat er niets op dat je wilt houden? Stop HolyArrs dan, kopieer je oude sleutel met dezelfde docker cp over de nieuwe, zet de backup terug en start daarna.

Als het niet werkt

Symptoom: “Backups are off in this build”. Oorzaak: deze kopie draait zonder backupbeheer. Oplossing: in de app is hier niets aan te doen; er zijn geen backupknoppen.

Symptoom: downloaden, verwijderen of terugzetten vraagt om je wachtwoord. Oorzaak: hiervoor is een recente aanmelding met wachtwoord nodig. Oplossing: meld je opnieuw aan met je wachtwoord en probeer het nog eens.

Symptoom: het terugzetten wordt geweigerd vanwege de hoofdsleutel. Oorzaak: de sleutel in de configuratiemap past niet bij de backup. Oplossing: zet de bijbehorende holyarrs.key terug en probeer het opnieuw.

Het terugzetten weigert ook een zip die te groot of beschadigd is, onverwachte bestanden bevat, uit een nieuwere databaseversie komt of gegevens bevat die jouw sleutel niet kan lezen.

Voor gevorderden

Wat er in een backup zit

Elke backup is een zip met de hoofddatabase, de Events-database als die er is, en backup.json (HolyArrs-versie, databaseversies, soort backup, tijdstip). Media, downloads, artwork, logs en de hoofdsleutel zitten er niet in.

Terugzetten vóór de eerste start

docker cp werkt voor een benoemd volume of een hostmap; HolyArrs geeft de bestanden in /config bij het starten aan jouw PUID en PGID. Met HOLYARRS_MASTER_KEY_FILE zet je de sleutel op dat pad op de host, leesbaar voor PUID en PGID.

1. Zet de zip, met ongewijzigde naam, in een map met de naam backups en kopieer die erin: docker cp backups holyarrs:/config/.
2. Voer het terugzetten eenmalig uit met dezelfde image:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Heb je een pad naar een sleutelbestand, voeg dan -e HOLYARRS_MASTER_KEY_FILE=<its path> toe, zodat het terugzetten met jouw sleutel controleert.
4. Start HolyArrs.

restore --list toont de namen van de backups die het ziet.

Gerelateerde pagina’s

• Updates
• Installeren
• Gezondheidscontroles