Backups

Gem en kopi af din opsætning, så du kan lægge den tilbage efter en dårlig opdatering, en defekt disk eller en flytning til en ny computer.

Før du begynder

• Settings > Backups (Indstillinger > Backups) kræver rettigheden Change settings (ændre indstillinger). Kun ejeren gendanner.
• Download, sletning og gendannelse kræver et login med adgangskode inden for de sidste par minutter.

Tag en backup

1. Åbn Settings > Backups.
2. Klik på Back up now (tag backup nu). Du bør kunne se den nye backup under Saved backups (gemte backups).
3. Klik på Download ud for den for at gemme en kopi uden for serveren.

Gem hovednøglen

Backups indeholder aldrig hovednøglen, som åbner adgangskoderne og API-nøglerne i dine indstillinger. Uden den rigtige nøgle kan en gendannet backup ikke læse dem.

1. Under Master key (hovednøgle) klikker ejeren på Download key kit (download nøglepakke).
2. Gem filen væk fra serveren og adskilt fra dine backups. Du bør kunne se advarslen om nøglepakken forsvinde fra Settings > Backups og fra tilstandstjekkene.

Når du skal bruge den senere, omdøb den til holyarrs.key og læg den i konfigurationsmappen. Er du ikke ejer? Bed ejeren om at downloade den.

Gendan en backup

Advarsel

Ændringer, der er lavet siden backuppen, går tabt. Hav den rigtige hovednøgle klar først.

1. Klik på Restore from a file (gendan fra en fil) og vælg en HolyArrs-backup som zip-fil.
2. Bekræft.
3. HolyArrs tjekker filen. Du bør kunne se Restore ready. It applies on the next start.
4. HolyArrs genstarter og lægger backuppen på plads. Med den anbefalede genstartspolitik i Docker sker det af sig selv.

Dine nuværende databaser flyttes til /config/backups/before-restore-<time>, så du kan fortryde en gendannelse.

Valg

Hvor ofte

Valg	Tager backup	Gemmer
Balanced (standard)	Hver dag	De seneste 7 dage og 4 ugentlige kopier
Light	Én gang om ugen	4 uger. Mindst plads
Careful	Hver dag	Alle kopier i 30 dage

Den nyeste planlagte backup bliver altid gemt. Disse regler rydder kun op i planlagte backups. Backups, du selv tager, bliver liggende, til du sletter dem (papirkurvsknappen på rækken; det kan ikke fortrydes). HolyArrs tager også en backup før en opdatering, der ændrer gemte data, og gemmer de nyeste 3; se Opdateringer.

Flyt til en ny computer

En ny installation laver sin egen hovednøgle ved første start. Den nøgle kan ikke åbne dine gamle backups, så gendannelsen bliver afvist. Læg den gamle nøgle på plads først. Eksemplerne kalder containeren holyarrs; brug dit eget navn.

1. Før første start skal du oprette containeren uden at starte den: docker compose create, eller din docker run-linje med docker create i stedet for docker run -d.
2. Kopier din gamle nøgle ind: docker cp holyarrs.key holyarrs:/config/. En nøglepakke omdøbt til holyarrs.key virker også. Det virker med et navngivet volume eller en mappe på hosten; HolyArrs giver filerne i /config til din PUID og PGID, når det starter. Bruger du HOLYARRS_MASTER_KEY_FILE, skal du i stedet lægge nøglen på den sti på hosten, så din PUID og PGID kan læse den.
3. Gendan backuppen. Vælg én fremgangsmåde:

   • Start HolyArrs, gennemfør første start, og brug derefter Restore from a file i Settings > Backups.

   • Eller gendan før første start. Læg zip-filen med uændret navn i en mappe, der hedder backups, og kopier den ind med docker cp backups holyarrs:/config/. Kør derefter gendannelsen én gang med det samme 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>

     Med en nøglefil på en sti skal du tilføje -e HOLYARRS_MASTER_KEY_FILE=<its path>, så gendannelsen tjekker mod din nøgle. restore --list viser de backupnavne, den kan se.

4. Start HolyArrs. Du bør kunne se dit bibliotek og dine indstillinger igen.

Har du startet den nye installation, før du kopierede nøglen? Hvis der ikke er noget på den, du vil beholde, så stop HolyArrs, kopier din gamle nøgle over den nye med den samme docker cp, gendan og start derefter.

Hvis det ikke virker

Symptom: “Backups are off in this build”. Årsag: denne kopi kører uden sin backupstyring. Løsning: ingen i appen; der er ingen backupknapper.

Symptom: Download, sletning eller gendannelse beder om din adgangskode. Årsag: de kræver et nyligt login med adgangskode. Løsning: log ind igen med din adgangskode og prøv igen.

Symptom: gendannelsen bliver afvist på grund af hovednøglen. Årsag: nøglen i konfigurationsmappen passer ikke til backuppen. Løsning: læg den rigtige holyarrs.key tilbage og prøv igen.

Gendannelsen afviser også en zip-fil, der er for stor eller beskadiget, indeholder uventede filer, kommer fra en nyere databaseversion eller indeholder data, som din nøgle ikke kan læse.

For erfarne

Hvad en backup indeholder

Hver backup er en zip-fil med hoveddatabasen, Events-databasen, hvis der er en, og backup.json (HolyArrs-version, databaseversioner, type backup, tidspunkt). Medier, downloads, artwork, logs og hovednøglen er ikke med.

Gendan før første start

docker cp virker med et navngivet volume eller en mappe på hosten; HolyArrs giver filerne i /config til din PUID og PGID, når det starter. Med HOLYARRS_MASTER_KEY_FILE skal du i stedet lægge nøglen på den sti på hosten, så PUID og PGID kan læse den.

1. Læg zip-filen med uændret navn i en mappe, der hedder backups, og kopier den ind: docker cp backups holyarrs:/config/.
2. Kør gendannelsen én gang med det samme 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. Med en nøglefil på en sti skal du tilføje -e HOLYARRS_MASTER_KEY_FILE=<its path>, så gendannelsen tjekker mod din nøgle.
4. Start HolyArrs.

restore --list viser de backupnavne, den kan se.

Se også

• Opdateringer
• Installation
• Tilstandstjek