Backuper

Ha en kopi av oppsettet ditt, så du kan legge det tilbake etter en dårlig oppdatering, en ødelagt disk eller en flytting til en ny maskin.

Før du begynner

• Settings > Backups (innstillinger > backuper) krever tillatelsen Change settings (endre innstillinger). Bare eieren gjenoppretter.
• Nedlasting, sletting og gjenoppretting krever at du har logget inn med passord de siste minuttene.

Ta en backup

1. Åpne Settings > Backups.
2. Trykk på Back up now (ta backup nå). Du skal se den nye backupen under Saved backups (lagrede backuper).
3. Trykk på Download (last ned) ved siden av den for å ha en kopi utenfor serveren.

Lagre hovednøkkelen

Backuper inneholder aldri hovednøkkelen. Den åpner passordene og API-nøklene i innstillingene dine. Uten riktig nøkkel kan ikke en gjenopprettet backup lese dem.

1. Under Master key (hovednøkkel) trykker eieren på Download key kit (last ned nøkkelpakke).
2. Oppbevar filen borte fra serveren og atskilt fra backupene. Du skal se advarselen om nøkkelpakken forsvinne fra Settings > Backups og fra helsesjekkene.

For å bruke den senere gir du den navnet holyarrs.key og legger den i konfigurasjonsmappen. Er du ikke eieren? Be eieren laste den ned.

Gjenopprett en backup

Fare

Endringer gjort etter backupen går tapt. Ha riktig hovednøkkel klar først.

1. Trykk på Restore from a file (gjenopprett fra fil) og velg en HolyArrs-backup som zip-fil.
2. Bekreft.
3. HolyArrs sjekker filen. Du skal se Restore ready. It applies on the next start.
4. HolyArrs starter på nytt og legger backupen på plass. Med den anbefalte omstartspolicyen i Docker skjer dette av seg selv.

De nåværende databasene dine flyttes til /config/backups/before-restore-<time>, så du kan angre en gjenoppretting.

Valg

Hvor ofte

Valg	Tar backup	Beholder
Balanced (standard)	Hver dag	Siste 7 dager og 4 ukentlige kopier
Light	Én gang i uken	4 uker. Minst plass
Careful	Hver dag	Alle kopier i 30 dager

Den nyeste planlagte backupen beholdes alltid. Disse reglene rydder bare opp i planlagte backuper. Backuper du tar selv, blir liggende til du sletter dem (søppelkasse-knappen på raden; dette kan ikke angres). HolyArrs tar også backup før en oppdatering som endrer lagrede data, og beholder de 3 nyeste. Se Oppdateringer.

Flytt til en ny maskin

En ny installasjon lager sin egen hovednøkkel ved første oppstart. Den nøkkelen kan ikke åpne de gamle backupene dine, så gjenopprettingen blir avvist. Legg den gamle nøkkelen på plass først. Eksemplene kaller containeren holyarrs; bruk ditt eget navn.

1. Før første oppstart oppretter du containeren uten å starte den: docker compose create, eller docker run-linjen din med docker create i stedet for docker run -d.
2. Kopier den gamle nøkkelen inn: docker cp holyarrs.key holyarrs:/config/. En nøkkelpakke som er gitt navnet holyarrs.key, fungerer også. Dette fungerer for et navngitt volume eller en vertsmappe; HolyArrs gir filene i /config til din PUID og PGID når det starter. Bruker du HOLYARRS_MASTER_KEY_FILE, legger du i stedet nøkkelen på den stien på verten, lesbar for din PUID og PGID.
3. Gjenopprett backupen. Velg én måte:

   • Start HolyArrs, fullfør første oppstart, og bruk så Restore from a file i Settings > Backups.

   • Eller gjenopprett før første oppstart. Legg zip-filen, uten å endre navnet, i en mappe som heter backups, og kopier den inn med docker cp backups holyarrs:/config/. Kjør så gjenopprettingen én gang med det samme imaget:

     • 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>

     Bruker du en nøkkelfil-sti, legger du til -e HOLYARRS_MASTER_KEY_FILE=<its path>, så gjenopprettingen sjekker mot nøkkelen din. restore --list viser backupnavnene den ser.

4. Start HolyArrs. Du skal se biblioteket og innstillingene dine igjen.

Startet du den nye installasjonen før du kopierte nøkkelen? Hvis ingenting på den er verdt å beholde, stopper du HolyArrs, kopierer den gamle nøkkelen over den nye med samme docker cp, gjenoppretter og starter.

Hvis det ikke fungerer

Symptom: «Backups are off in this build». Årsak: denne kopien kjører uten backupbehandleren sin. Løsning: ingen i appen; det finnes ingen backupkontroller.

Symptom: Nedlasting, sletting eller gjenoppretting ber om passordet ditt. Årsak: disse krever en nylig innlogging med passord. Løsning: logg inn på nytt med passordet ditt og prøv igjen.

Symptom: gjenopprettingen avvises på grunn av hovednøkkelen. Årsak: nøkkelen i konfigurasjonsmappen passer ikke til backupen. Løsning: legg riktig holyarrs.key tilbake og prøv igjen.

Gjenopprettingen avviser også en zip-fil som er for stor eller skadet, inneholder uventede filer, kommer fra en nyere databaseversjon eller inneholder data nøkkelen din ikke kan lese.

For viderekomne

Hva en backup inneholder

Hver backup er en zip-fil med hoveddatabasen, Events-databasen hvis det finnes en, og backup.json (HolyArrs-versjon, databaseversjoner, type backup, tidspunkt). Medier, nedlastinger, artwork, logger og hovednøkkelen er ikke med.

Gjenopprett før første oppstart

docker cp fungerer for et navngitt volume eller en vertsmappe; HolyArrs gir filene i /config til din PUID og PGID når det starter. Med HOLYARRS_MASTER_KEY_FILE legger du i stedet nøkkelen på den stien på verten, lesbar for PUID og PGID.

1. Legg zip-filen, uten å endre navnet, i en mappe som heter backups, og kopier den inn: docker cp backups holyarrs:/config/.
2. Kjør gjenopprettingen én gang med det samme imaget:
   • 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. Bruker du en nøkkelfil-sti, legger du til -e HOLYARRS_MASTER_KEY_FILE=<its path>, så gjenopprettingen sjekker mot nøkkelen din.
4. Start HolyArrs.

restore --list viser backupnavnene den ser.

Relatert

• Oppdateringer
• Installasjon
• Helsesjekker