Backupy

Trzymaj kopię swojej konfiguracji, żeby ją przywrócić po nieudanej aktualizacji, awarii dysku albo przeprowadzce na nowy komputer.

Zanim zaczniesz

• Settings > Backups (Ustawienia > Backupy) wymaga uprawnienia Change settings (zmiana ustawień). Przywracać może tylko właściciel.
• Pobieranie, usuwanie i przywracanie wymagają logowania hasłem z ostatnich kilku minut.

Zrób backup

1. Otwórz Settings > Backups.
2. Kliknij Back up now (zrób backup teraz). Nowy backup powinien pojawić się w sekcji Saved backups (zapisane backupy).
3. Kliknij Download (pobierz) obok niego, żeby mieć kopię poza serwerem.

Zapisz klucz główny

Backupy nigdy nie zawierają klucza głównego, który otwiera hasła i klucze API z twoich ustawień. Bez pasującego klucza przywrócony backup nie odczyta ich.

1. W sekcji Master key (klucz główny) właściciel klika Download key kit (pobierz zestaw z kluczem).
2. Trzymaj ten plik z dala od serwera i osobno od backupów. Ostrzeżenie o zestawie z kluczem powinno zniknąć z Settings > Backups i z kontroli kondycji.

Żeby użyć go później, zmień jego nazwę na holyarrs.key i wrzuć do folderu konfiguracji. Nie jesteś właścicielem? Poproś właściciela o pobranie.

Przywróć backup

Ważne

Zmiany wprowadzone po zrobieniu backupu przepadną. Najpierw przygotuj pasujący klucz główny.

1. Kliknij Restore from a file (przywróć z pliku) i wybierz zip z backupem HolyArrs.
2. Potwierdź.
3. HolyArrs sprawdza plik. Zobaczysz Restore ready. It applies on the next start. (przywracanie gotowe, zadziała przy następnym uruchomieniu).
4. HolyArrs restartuje się i wczytuje backup. Przy zalecanej polityce restartu Dockera dzieje się to automatycznie.

Obecne bazy danych trafiają do /config/backups/before-restore-<time>, więc możesz cofnąć przywracanie.

Opcje

Jak często

Opcja	Robi backup	Przechowuje
Balanced (zrównoważone, domyślnie)	Codziennie	Ostatnie 7 dni i 4 kopie tygodniowe
Light (lekkie)	Raz w tygodniu	4 tygodnie. Najmniej miejsca
Careful (ostrożne)	Codziennie	Każda kopia przez 30 dni

Najnowszy zaplanowany backup zostaje zawsze. Te reguły porządkują tylko backupy zaplanowane. Backupy zrobione przez ciebie zostają, dopóki ich nie usuniesz (przycisk kosza w wierszu; tego nie da się cofnąć). HolyArrs robi też backup przed aktualizacją, która zmienia zapisane dane, i trzyma 3 najnowsze; zobacz Aktualizacje.

Przejście na nowy komputer

Nowa instalacja przy pierwszym uruchomieniu tworzy własny klucz główny. Ten klucz nie otworzy twoich starych backupów, więc przywracanie zostanie odrzucone. Najpierw wstaw stary klucz. W przykładach kontener nazywa się holyarrs; użyj własnej nazwy.

1. Przed pierwszym uruchomieniem utwórz kontener bez uruchamiania: docker compose create albo twoja linia docker run, z docker create zamiast docker run -d.
2. Skopiuj tam stary klucz: docker cp holyarrs.key holyarrs:/config/. Zestaw z kluczem z nazwą zmienioną na holyarrs.key też zadziała. Działa to dla nazwanego wolumenu i dla folderu na hoście; HolyArrs przy starcie przekazuje pliki w /config twoim PUID i PGID. Jeśli używasz HOLYARRS_MASTER_KEY_FILE, połóż klucz pod tą ścieżką na hoście, z odczytem dla twoich PUID i PGID.
3. Przywróć backup. Wybierz jeden sposób:

   • Uruchom HolyArrs, przejdź pierwsze uruchomienie, a potem użyj Restore from a file w Settings > Backups.

   • Albo przywróć przed pierwszym uruchomieniem. Połóż zip, bez zmiany nazwy, w folderze o nazwie backups i skopiuj go: docker cp backups holyarrs:/config/. Potem wykonaj przywracanie jednorazowo z tym samym 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>

     Przy kluczu pod własną ścieżką dodaj -e HOLYARRS_MASTER_KEY_FILE=<its path>, żeby przywracanie sprawdzało się z twoim kluczem. restore --list pokazuje nazwy backupów, które widzi.

4. Uruchom HolyArrs. Twoja biblioteka i ustawienia powinny wrócić.

Nowa instalacja wystartowała, zanim skopiowano klucz? Jeśli nic na niej nie jest warte zachowania, zatrzymaj HolyArrs, nadpisz nowy klucz starym tym samym docker cp, przywróć backup i uruchom.

Jeśli to nie działa

Objaw: „Backups are off in this build“ (backupy są wyłączone w tej wersji). Przyczyna: ta kopia działa bez menedżera backupów. Rozwiązanie: w aplikacji nic nie zrobisz; nie ma opcji backupu.

Objaw: pobieranie, usuwanie lub przywracanie prosi o hasło. Przyczyna: wymagają niedawnego logowania hasłem. Rozwiązanie: zaloguj się ponownie hasłem i spróbuj jeszcze raz.

Objaw: przywracanie jest odrzucone z powodu klucza głównego. Przyczyna: klucz w folderze konfiguracji nie pasuje do backupu. Rozwiązanie: włóż z powrotem pasujący holyarrs.key i spróbuj ponownie.

Przywracanie odrzuci też zip, który jest za duży lub uszkodzony, zawiera nieoczekiwane pliki, pochodzi z nowszej wersji bazy danych albo ma dane, których twój klucz nie odczyta.

Dla zaawansowanych

Co jest w backupie

Każdy backup to zip z główną bazą danych, bazą zdarzeń (jeśli jest) i plikiem backup.json (wersja HolyArrs, wersje baz danych, rodzaj backupu, czas wykonania). Nie ma w nim multimediów, pobranych plików, grafik, logów ani klucza głównego.

Przywracanie przed pierwszym uruchomieniem

docker cp działa dla nazwanego wolumenu i dla folderu na hoście; HolyArrs przy starcie przekazuje pliki w /config twoim PUID i PGID. Przy HOLYARRS_MASTER_KEY_FILE połóż klucz pod tą ścieżką na hoście, z odczytem dla PUID i PGID.

1. Połóż zip, bez zmiany nazwy, w folderze o nazwie backups i skopiuj go: docker cp backups holyarrs:/config/.
2. Wykonaj przywracanie jednorazowo z tym samym 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. Przy kluczu pod własną ścieżką dodaj -e HOLYARRS_MASTER_KEY_FILE=<its path>, żeby przywracanie sprawdzało się z twoim kluczem.
4. Uruchom HolyArrs.

restore --list pokazuje nazwy backupów, które widzi.

Powiązane strony

• Aktualizacje
• Instalacja
• Kontrole kondycji