Чтение прежних приложений

Прочитайте настройки прежнего приложения, через само приложение или из его резервной копии. Это шаг 1 переноса. Чтение ничего не меняет ни в HolyArrs, ни в прежнем приложении.

Чтение — это копия настроек одного приложения, которую хранит HolyArrs. Она хранится, пока вы её не перенесёте или не удалите.

Прочитайте приложение

1. Откройте Settings > Move from other apps (Настройки > Переезд с других приложений) и нажмите Add an app (добавить приложение).
2. Выберите приложение, затем Through the app (через приложение) или From a backup (из резервной копии).
3. Нажмите Check connection (проверить соединение). Через несколько секунд вы увидите приложение и его версию.
4. Запустите чтение. Большая медиатека читается несколько минут. Stop reading (остановить чтение) останавливает его; закрытие панели — нет.
5. Чтение появится в списке. Следующее приложение добавьте так же.

Edit (изменить) в строке читает это приложение заново. Remove (удалить) удаляет чтение.

Варианты выбора

Через приложение

Введите адрес приложения и ключ API. Для qBittorrent введите имя пользователя и пароль, а в версии 5.2 и новее можно ввести его ключ API.

Прежние приложения обычно находятся в вашей домашней сети, поэтому включите для чтения переключатель локальной сети. Адреса облачных метаданных остаются заблокированными, и приложение не может перенаправить HolyArrs на другой адрес.

Из резервной копии

Введите полный путь на сервере HolyArrs к одному из следующего:

• zip-архив резервной копии Radarr, Sonarr, Lidarr, Prowlarr или Bazarr,
• папка конфигурации Seerr, Overseerr, qBittorrent или SABnzbd,
• один файл базы данных или настроек.

При чтении из резервной копии ключ не сохраняется.

Что читается

Приложение	Что читается
Radarr, Sonarr, Lidarr	Каждый фильм, сериал (с сезонами) или исполнитель: идентификаторы, папка, признак отслеживания, профиль качества, метки, дата добавления. А также папки Медиатеки, метки, профили качества, пользовательские форматы, правила по словам в релизах, правила ожидания, именование, индексаторы, клиенты загрузки, списки, уведомления, запись метаданных, исключения, языковые профили (Sonarr v3), профили метаданных (Lidarr) и задержка доступности в Radarr.
Prowlarr	Индексаторы, связи с приложениями, профили синхронизации, прокси индексаторов, клиенты загрузки, уведомления.
Bazarr	Включённые языки, языковые профили, включённые сайты субтитров, профили по умолчанию.
qBittorrent, SABnzbd	Адрес, порт, имя пользователя, папки загрузок, категории и (для SABnzbd) Usenet-серверы.
Seerr, Overseerr	Люди (имя, адрес электронной почты, роль, права, лимиты запросов), лимиты по умолчанию и каждый запрос, который ждёт одобрения или одобрен: кто запросил, когда и что. Выполненные и отклонённые запросы только считаются. Аватары не читаются.

Читается больше, чем переносится, и это сделано намеренно: всё, что прочитано, но не перенесено, попадает в список not moved (не перенесено) с указанием причины.

Ключи и пароли

Чтение никогда не содержит ключей, паролей, токенов и cookie, даже если в резервной копии они лежат открытым текстом. Каждый из них перечислен в разделе needs re-entry (нужно ввести заново), например indexer "Nyaa": apiKey.

Ссылки считаются секретами, потому что в них прячутся токены. Ссылки уведомлений, адреса RSS-лент и дополнительные параметры в свободной форме не переносятся и попадают в список. От адреса индексатора остаются только хост и путь API.

Ключ, который вы ввели

Когда Владелец читает приложение с введённым ключом, HolyArrs сохраняет этот адрес и ключ в своём зашифрованном хранилище. В следующий раз Edit читает заново с включённым Use the saved key (использовать сохранённый ключ), и ключ отправляется только на сохранённый адрес. HolyArrs никогда его не показывает.

Сохранённый ключ удаляется, когда
вы удаляете чтение этого приложения
перенос завершается без единой ошибки (если хоть один элемент не перенёсся, ключи сохраняются, чтобы вы могли перенести снова)
вы выполняете holyarrs import-secrets -forget-move-credentials

Кто может читать

Владелец и Администраторы, вошедшие со своим паролем. Пропуск входа для локальной сети не считается. Ключу API нужна область admin.

Если не работает

Признак проблемы	Причина	Решение
Check connection завершается ошибкой	Адрес проверяется с сервера HolyArrs.	Используйте адрес, который доступен серверу. Для приложения в домашней сети включите переключатель локальной сети.
Ключ неверный	Ошибка при копировании, или qBittorrent ждёт имя пользователя.	Скопируйте ключ заново из настроек прежнего приложения.
Резервная копия отклонена	Zip-архив был изменён, или путь находится вне контейнера.	Используйте zip-архив резервной копии, созданный самим приложением, без изменений, по его пути внутри контейнера HolyArrs.
Чтение слишком большое	Есть лимиты на одно чтение и на сервер.	Удалите старые чтения, которые больше не нужны.

Для опытных

Работа с резервными копиями и лимиты

Правило	Значение
Копируемые файлы	Только нужные файлы, во временную закрытую папку, которая удаляется после чтения.
Размер одного копируемого файла	Не больше 1 ГБ.
config.xml приложения arr	Никогда не копируется; в нём лежит ключ API.
База данных	Открывается только для чтения.
Отклоняется целиком, когда	запись указывает за пределы zip-архива, в нём есть ссылка или файл распаковывается намного больше своего размера.
Резервных копий одновременно	1.
Хранится на одно чтение	16 МБ.
Хранится чтений	50 самых новых.

API

Маршрут	Что делает
POST /api/v1/migrate/probe	Сообщает, какое приложение и какой версии отвечает или что это за резервная копия.
POST /api/v1/migrate/read	Читает все настройки и сохраняет их.
GET /api/v1/migrate/snapshots	Список чтений, сначала новые.
GET /api/v1/migrate/snapshots/{id}	Одно чтение со всем, что в нём есть.
DELETE /api/v1/migrate/snapshots/{id}	Удаляет чтение и ключ, сохранённый для этого приложения.
GET /api/v1/migrate/saved-keys	Приложения с сохранённым ключом и их адреса, но не сам ключ. Только для Владельца.
DELETE /api/v1/migrate/saved-keys	Удаляет все сохранённые ключи или один, если указать ?kind=. Только для Владельца.

В теле запросов probe и read указывается приложение: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent или sabnzbd. Добавьте url и key (или username и password) либо path. Добавьте allow_local_network, чтобы обращаться к домашней сети, и use_saved_key, чтобы использовать сохранённый ключ.

См. также

• Переезд с других приложений
• Импорт ключей из файла