Varmuuskopiot

Pidä kopio asetuksistasi, jotta voit laittaa ne takaisin huonon päivityksen, rikkoutuneen levyn tai uuteen koneeseen siirtymisen jälkeen.

Ennen kuin aloitat

• Sivu Settings > Backups (asetukset > varmuuskopiot) vaatii oikeuden Change settings (muuta asetuksia). Vain omistaja palauttaa.
• Lataus, poisto ja palautus vaativat salasanalla kirjautumisen muutaman viime minuutin ajalta.

Tee varmuuskopio

1. Avaa Settings > Backups.
2. Napsauta Back up now (varmuuskopioi nyt). Uuden varmuuskopion pitäisi näkyä kohdassa Saved backups (tallennetut varmuuskopiot).
3. Napsauta sen vieressä Download (lataa), niin saat kopion talteen palvelimen ulkopuolelle.

Tallenna pääavain

Varmuuskopiot eivät sisällä pääavainta, joka avaa asetuksissasi olevat salasanat ja API-avaimet. Ilman oikeaa avainta palautettu varmuuskopio ei pysty lukemaan niitä.

1. Omistaja napsauttaa kohdassa Master key (pääavain) Download key kit (lataa avainpaketti).
2. Säilytä tiedosto palvelimesta erillään ja varmuuskopioistasi erillään. Avainpaketin varoituksen pitäisi poistua sivulta Settings > Backups ja kuntotarkistuksista.

Kun haluat käyttää sitä myöhemmin, nimeä se uudelleen nimellä holyarrs.key ja laita se asetuskansioon. Etkö ole omistaja? Pyydä omistajaa lataamaan se.

Palauta varmuuskopio

Vaara

Varmuuskopion jälkeen tehdyt muutokset menetetään. Pidä ensin valmiina oikea pääavain.

1. Napsauta Restore from a file (palauta tiedostosta) ja valitse HolyArrsin varmuuskopion zip-tiedosto.
2. Vahvista.
3. HolyArrs tarkistaa tiedoston. Näet viestin Restore ready. It applies on the next start.
4. HolyArrs käynnistyy uudelleen ja laittaa varmuuskopion paikalleen. Suositellulla Dockerin uudelleenkäynnistyskäytännöllä tämä tapahtuu itsestään.

Nykyiset tietokantasi siirtyvät kansioon /config/backups/before-restore-<time>, joten voit perua palautuksen.

Vaihtoehdot

Kuinka usein

Vaihtoehto	Varmuuskopioi	Säilyttää
Balanced (tasapainoinen, oletus)	Joka päivä	Viimeiset 7 päivää ja 4 viikkokopiota
Light (kevyt)	Kerran viikossa	4 viikkoa. Vie vähiten tilaa
Careful (huolellinen)	Joka päivä	Jokainen kopio 30 päivän ajan

Uusin ajastettu varmuuskopio säilytetään aina. Nämä säännöt siivoavat vain ajastetut varmuuskopiot. Itse tekemäsi varmuuskopiot säilyvät, kunnes poistat ne (roskakorin painike rivillä; tätä ei voi perua). HolyArrs varmuuskopioi myös ennen päivitystä, joka muuttaa tallennettuja tietoja, ja säilyttää uusimmat 3. Katso Päivitykset.

Siirto uudelle koneelle

Uusi asennus tekee oman pääavaimensa ensimmäisellä käynnistyksellä. Se avain ei avaa vanhoja varmuuskopioitasi, joten palautus hylätään. Laita vanha avain ensin paikalleen. Esimerkeissä containerin nimi on holyarrs; käytä omaa nimeäsi.

1. Luo container ennen ensimmäistä käynnistystä käynnistämättä sitä: docker compose create, tai oma docker run -rivisi komennolla docker create komennon docker run -d tilalla.
2. Kopioi vanha avaimesi sisään: docker cp holyarrs.key holyarrs:/config/. Myös uudelleennimetty avainpaketti holyarrs.key käy. Tämä toimii nimetylle volumelle tai isäntäkoneen kansiolle; HolyArrs antaa kansion /config tiedostot PUID- ja PGID-käyttäjälle käynnistyessään. Jos käytät asetusta HOLYARRS_MASTER_KEY_FILE, laita avain sen sijaan isäntäkoneella siihen polkuun, ja varmista, että PUID ja PGID voivat lukea sen.
3. Palauta varmuuskopio. Valitse yksi tapa:

   • Käynnistä HolyArrs, käy ensimmäinen käynnistys läpi ja käytä sitten Restore from a file -toimintoa sivulla Settings > Backups.

   • Tai palauta ennen ensimmäistä käynnistystä. Laita zip-tiedosto muuttamattomalla nimellä kansioon nimeltä backups ja kopioi se sisään komennolla docker cp backups holyarrs:/config/. Suorita sitten palautus kerran samalla imagella:

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

     Jos käytät avaintiedoston polkua, lisää -e HOLYARRS_MASTER_KEY_FILE=<its path>, jotta palautus tarkistaa oman avaimesi. Komento restore --list näyttää varmuuskopioiden nimet, jotka se näkee.

4. Käynnistä HolyArrs. Kirjastosi ja asetustesi pitäisi olla takaisin.

Käynnistitkö uuden asennuksen ennen avaimen kopiointia? Jos siinä ei ole mitään säilytettävää, pysäytä HolyArrs, kopioi vanha avaimesi uuden päälle samalla docker cp -komennolla, palauta ja käynnistä sitten.

Jos se ei toimi

Oire: “Backups are off in this build”. Syy: tämä kopio toimii ilman varmuuskopioiden hallintaa. Ratkaisu: sovelluksessa ei ole ratkaisua; varmuuskopiointiin ei ole säätimiä.

Oire: lataus, poisto tai palautus kysyy salasanaasi. Syy: ne vaativat tuoreen salasanalla kirjautumisen. Ratkaisu: kirjaudu uudelleen salasanallasi ja yritä uudelleen.

Oire: palautus hylätään pääavaimen takia. Syy: asetuskansion avain ei vastaa varmuuskopiota. Ratkaisu: laita oikea holyarrs.key takaisin ja yritä uudelleen.

Palautus hylkää myös zip-tiedoston, joka on liian suuri tai vioittunut, sisältää odottamattomia tiedostoja, on peräisin uudemmasta tietokantaversiosta tai sisältää tietoja, joita avaimesi ei pysty lukemaan.

Asiantuntijoille

Mitä varmuuskopiossa on

Jokainen varmuuskopio on zip, jossa on päätietokanta, Events-tietokanta jos sellainen on, ja backup.json (HolyArrsin versio, tietokantojen versiot, varmuuskopion laji, tekoaika). Media, lataukset, kuvitus, lokit ja pääavain eivät ole mukana.

Palautus ennen ensimmäistä käynnistystä

docker cp toimii nimetylle volumelle tai isäntäkoneen kansiolle; HolyArrs antaa kansion /config tiedostot PUID- ja PGID-käyttäjälle käynnistyessään. Jos käytät asetusta HOLYARRS_MASTER_KEY_FILE, laita avain sen sijaan siihen isäntäkoneen polkuun, ja varmista, että PUID ja PGID voivat lukea sen.

1. Laita zip-tiedosto muuttamattomalla nimellä kansioon nimeltä backups ja kopioi se sisään: docker cp backups holyarrs:/config/.
2. Suorita palautus kerran samalla imagella:
   • 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. Jos käytät avaintiedoston polkua, lisää -e HOLYARRS_MASTER_KEY_FILE=<its path>, jotta palautus tarkistaa oman avaimesi.
4. Käynnistä HolyArrs.

Komento restore --list näyttää varmuuskopioiden nimet, jotka se näkee.

Aiheesta lisää

• Päivitykset
• Asennus
• Kuntotarkistukset