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

Держите копию своей настройки, чтобы вернуть её после неудачного обновления, поломки диска или переезда на новый компьютер.

Перед началом

• Для 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 и положите в папку конфигурации. Вы не владелец? Попросите владельца скачать его.

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

Опасно

Изменения, сделанные после резервной копии, будут потеряны. Сначала подготовьте подходящий мастер-ключ.

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 run -d стоит docker create.
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 с основной базой данных, базой данных событий, если она есть, и файлом 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 показывает имена резервных копий, которые он видит.

См. также

• Обновления
• Установка
• Проверки исправности