Резервни копия

Дръж копие на настройката си, за да я върнеш след лоша актуализация, повреден диск или преместване на нов компютър.

Преди да започнеш

• Settings > Backups (Настройки > Резервни копия) иска правото Change settings (промяна на настройки). Само собственикът възстановява.
• Изтеглянето, изтриването и възстановяването искат вход с парола от последните няколко минути.

Направи резервно копие

1. Отвори Settings > Backups.
2. Избери Back up now (направи копие сега). Трябва да видиш новото копие под Saved backups (запазени копия).
3. Избери Download (изтегли) до него, за да държиш копие извън сървъра.

Запази главния ключ

Резервните копия никога не съдържат главния ключ, който отваря паролите и API ключовете в настройките ти. Без съответстващия ключ възстановеното копие не може да ги прочете.

1. Под Master key (главен ключ) собственикът избира Download key kit (изтегли пакета с ключа).
2. Дръж файла далеч от сървъра и отделно от резервните копия. Трябва да видиш как предупреждението за пакета с ключа изчезва от Settings > Backups и от проверките на здравето.

За да го ползваш по-късно, преименувай го на holyarrs.key и го сложи в папката с конфигурация. Не си собственикът? Помоли собственика да го изтегли.

Възстанови резервно копие

Danger

Промените, направени след копието, се губят. Първо приготви съответстващия главен ключ.

1. Избери Restore from a file (възстановяване от файл) и посочи zip на резервно копие на HolyArrs.
2. Потвърди.
3. HolyArrs проверява файла. Трябва да видиш Restore ready. It applies on the next start. (възстановяването е готово, прилага се при следващото стартиране).
4. HolyArrs се рестартира и поставя копието на мястото му. С препоръчаната политика за рестарт на Docker това става само.

Сегашните ти бази данни се местят в /config/backups/before-restore-<time>, така че можеш да върнеш възстановяването.

Възможности

Колко често

Възможност	Прави копие	Пази
Balanced (балансирано; по подразбиране)	Всеки ден	Последните 7 дни и 4 седмични копия
Light (леко)	Веднъж седмично	4 седмици. Най-малко място
Careful (грижливо)	Всеки ден	Всяко копие за 30 дни

Най-новото копие по график се пази винаги. Тези правила чистят само копията по график. Копията, които правиш ти, остават, докато не ги изтриеш (бутонът с кошче на реда; не може да се върне). HolyArrs прави копие и преди актуализация, която променя запазените данни, и пази най-новите 3; виж Актуализации.

Премести на нов компютър

Новата инсталация прави свой главен ключ при първото стартиране. Този ключ не може да отваря старите ти копия, така че възстановяването се отказва. Първо сложи стария ключ на мястото му. В примерите контейнерът се казва holyarrs; ползвай своето име.

1. Преди първото стартиране създай контейнера, без да го стартираш: docker compose create, или реда си с docker run, като docker create замени docker run -d.
2. Копирай стария си ключ вътре: docker cp holyarrs.key holyarrs:/config/. Пакет с ключа, преименуван на holyarrs.key, също върши работа. Това става за именуван том или папка на хоста; HolyArrs предава файловете в /config на твоите PUID и PGID при стартиране. Ако ползваш HOLYARRS_MASTER_KEY_FILE, сложи ключа на този път на хоста, четим от твоите PUID и PGID.
3. Възстанови копието. Избери един начин:

   • Стартирай HolyArrs, мини първото стартиране, после ползвай Restore from a file в Settings > Backups.

   • Или възстанови преди първото стартиране. Сложи zip файла, с непроменено име, в папка на име backups и го копирай вътре с docker cp backups holyarrs:/config/. След това изпълни възстановяването веднъж със същия образ:

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

     При път към файл с ключ добави -e HOLYARRS_MASTER_KEY_FILE=<its path>, за да се провери възстановяването спрямо твоя ключ. restore --list показва имената на копията, които вижда.

4. Стартирай HolyArrs. Трябва да видиш Библиотеката и настройките си обратно.

Стартирал си новата инсталация, преди да копираш ключа? Ако в нея няма нищо ценно, спри HolyArrs, копирай стария ключ върху новия със същия docker cp, възстанови, после стартирай.

Ако не работи

Проблем: „Backups are off in this build“ (резервните копия са изключени в тази версия). Причина: това копие работи без своя мениджър на резервни копия. Решение: няма в приложението; няма бутони за резервни копия.

Проблем: изтеглянето, изтриването или възстановяването иска паролата ти. Причина: те искат скорошен вход с парола. Решение: влез отново с паролата си и опитай пак.

Проблем: възстановяването се отказва заради главния ключ. Причина: ключът в папката с конфигурация не съвпада с копието. Решение: върни съответстващия holyarrs.key и опитай пак.

Възстановяването отказва и zip, който е твърде голям или повреден, съдържа неочаквани файлове, идва от по-нова версия на базата данни или съдържа данни, които ключът ти не може да прочете.

За експерти

Какво има в едно резервно копие

Всяко копие е zip с основната база данни, базата със събитията (Events), ако има такава, и backup.json (версия на HolyArrs, версии на базите данни, вид на копието, време на създаване). Медията, изтеглянията, картинките, дневниците и главния ключ не са в него.

Възстановяване преди първото стартиране

docker cp работи за именуван том или папка на хоста; HolyArrs предава файловете в /config на твоите PUID и PGID при стартиране. С HOLYARRS_MASTER_KEY_FILE сложи ключа на този път на хоста, четим от PUID и PGID.

1. Сложи zip файла, с непроменено име, в папка на име backups и го копирай вътре: docker cp backups holyarrs:/config/.
2. Изпълни възстановяването веднъж със същия образ:
   • 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. При път към файл с ключ добави -e HOLYARRS_MASTER_KEY_FILE=<its path>, за да се провери възстановяването спрямо твоя ключ.
4. Стартирай HolyArrs.

restore --list показва имената на копията, които вижда.

Свързано

• Актуализации
• Инсталиране
• Проверки на здравето