Backuper

Spara en kopia av din konfiguration som du kan lägga tillbaka efter en dålig uppdatering, en trasig disk eller en flytt till en ny dator.

Innan du börjar

• Settings > Backups (inställningar > backuper) kräver behörigheten Change settings (ändra inställningar). Bara ägaren kan återställa.
• Nedladdning, radering och återställning kräver en inloggning med lösenord de senaste minuterna.

Gör en backup

1. Öppna Settings > Backups.
2. Klicka på Back up now (ta backup nu). Du ska se den nya backupen under Saved backups (sparade backuper).
3. Klicka på Download (ladda ner) bredvid den för att spara en kopia utanför servern.

Spara huvudnyckeln

Backuper innehåller aldrig huvudnyckeln, som öppnar lösenorden och API-nycklarna i dina inställningar. Utan rätt nyckel kan en återställd backup inte läsa dem.

1. Under Master key (huvudnyckel) klickar ägaren på Download key kit (ladda ner nyckelpaket).
2. Förvara filen borta från servern och skild från dina backuper. Du ska se varningen om nyckelpaketet försvinna från Settings > Backups och från hälsokontrollerna.

När du ska använda den döper du om den till holyarrs.key och lägger den i konfigurationsmappen. Är du inte ägaren? Be ägaren ladda ner den.

Återställ en backup

Danger

Ändringar som gjorts sedan backupen går förlorade. Ha rätt huvudnyckel redo först.

1. Klicka på Restore from a file (återställ från en fil) och välj en HolyArrs-backup i zip-format.
2. Bekräfta.
3. HolyArrs kontrollerar filen. Du ska se Restore ready. It applies on the next start. (återställningen är redo och tillämpas vid nästa start).
4. HolyArrs startar om och lägger backupen på plats. Med den rekommenderade omstartspolicyn i Docker sker det av sig självt.

Dina nuvarande databaser flyttas till /config/backups/before-restore-<time>, så att du kan ångra en återställning.

Val

Hur ofta

Val	Tar backup	Sparar
Balanced (balanserad, standard)	Varje dag	De senaste 7 dagarna och 4 veckokopior
Light (lätt)	En gång i veckan	4 veckor. Minst utrymme
Careful (noggrann)	Varje dag	Varje kopia i 30 dagar

Den senaste schemalagda backupen sparas alltid. De här reglerna rensar bara schemalagda backuper. Backuper du gör själv ligger kvar tills du raderar dem (papperskorgsknappen på raden; det går inte att ångra). HolyArrs tar också backup före en uppdatering som ändrar lagrad data och sparar de 3 senaste. Se Uppdateringar.

Flytta till en ny dator

En ny installation skapar sin egen huvudnyckel vid första start. Den nyckeln kan inte öppna dina gamla backuper, så återställningen nekas. Lägg den gamla nyckeln på plats först. I exemplen heter containern holyarrs; använd ditt eget namn.

1. Före första start skapar du containern utan att starta den: docker compose create, eller din docker run-rad med docker create i stället för docker run -d.
2. Kopiera in din gamla nyckel: docker cp holyarrs.key holyarrs:/config/. Ett nyckelpaket som du döpt om till holyarrs.key fungerar också. Det fungerar för en namngiven volym eller en värdmapp; HolyArrs ger filerna i /config till din PUID och PGID när det startar. Om du använder HOLYARRS_MASTER_KEY_FILE lägger du i stället nyckeln på den sökvägen på hosten, läsbar för din PUID och PGID.
3. Återställ backupen. Välj ett sätt:

   • Starta HolyArrs, gör klart första start och använd sedan Restore from a file i Settings > Backups.

   • Eller återställ före första start. Lägg zip-filen, med oförändrat namn, i en mapp som heter backups och kopiera in den med docker cp backups holyarrs:/config/. Kör sedan återställningen en gång med samma 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>

     Om du har en sökväg till nyckelfilen lägger du till -e HOLYARRS_MASTER_KEY_FILE=<its path>, så att återställningen kontrollerar mot din nyckel. restore --list visar namnen på de backuper den ser.

4. Starta HolyArrs. Du ska se ditt bibliotek och dina inställningar igen.

Har du startat den nya installationen innan du kopierade nyckeln? Om inget på den är värt att spara stoppar du HolyArrs, kopierar din gamla nyckel över den nya med samma docker cp, återställer och startar sedan.

Om det inte fungerar

Symptom: “Backups are off in this build”. Orsak: den här kopian körs utan backuphanteraren. Lösning: ingen i appen; det finns inga backupkontroller.

Symptom: nedladdning, radering eller återställning ber om ditt lösenord. Orsak: de kräver en nyligen genomförd inloggning med lösenord. Lösning: logga in igen med ditt lösenord och försök på nytt.

Symptom: återställningen nekas på grund av huvudnyckeln. Orsak: nyckeln i konfigurationsmappen passar inte backupen. Lösning: lägg tillbaka rätt holyarrs.key och försök igen.

Återställningen nekar också en zip-fil som är för stor eller skadad, innehåller oväntade filer, kommer från en nyare databasversion eller innehåller data som din nyckel inte kan läsa.

För experter

Vad en backup innehåller

Varje backup är en zip-fil med huvuddatabasen, Events-databasen om det finns en, och backup.json (HolyArrs-version, databasversioner, typ av backup, tidpunkt). Media, nedladdningar, omslagsbilder, loggar och huvudnyckeln ingår inte.

Återställ före första start

docker cp fungerar för en namngiven volym eller en värdmapp; HolyArrs ger filerna i /config till din PUID och PGID när det startar. Med HOLYARRS_MASTER_KEY_FILE lägger du i stället nyckeln på den sökvägen på hosten, läsbar för PUID och PGID.

1. Lägg zip-filen, med oförändrat namn, i en mapp som heter backups och kopiera in den: docker cp backups holyarrs:/config/.
2. Kör återställningen en gång med samma 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. Om du har en sökväg till nyckelfilen lägger du till -e HOLYARRS_MASTER_KEY_FILE=<its path>, så att återställningen kontrollerar mot din nyckel.
4. Starta HolyArrs.

restore --list visar namnen på de backuper den ser.

Relaterat

• Uppdateringar
• Installation
• Hälsokontroller