Оновлення

HolyArrs повідомляє, що вийшла нова версія, але ніколи сам її не встановлює. Ти завантажуєш новий image тоді, коли тобі зручно.

Перевірка наявності нової версії

1. Відкрий сторінку Status (стан): http://your-server:6262/health.
2. Знайди блок Updates (оновлення). Ти маєш побачити одне з таких повідомлень:

Повідомлення	Що це означає
“HolyArrs 1.2.0 is out, newer than this one.”	Онови, коли буде зручно
“This is the newest version.”	Нічого робити не треба
“No HolyArrs release is published yet.”	Стрічка порожня. Нічого не зламано
“The last check did not work: …”	Стрічку не вдалося дістати, часто через відсутність інтернету
“The update check is off: …”	Вимкнено в налаштуваннях

3. Щоб запитати зараз, натисни Check now (перевірити зараз), або Check again (перевірити знову). Потрібен дозвіл Change settings (змінювати налаштування).

Нова версія також з’являється як попередження справності. Невдала перевірка видна лише в блоці Updates.

Оновлення

1. Завантаж новий image і перезапусти: docker compose pull, потім docker compose up -d.
2. HolyArrs запускається. Якщо нова версія змінює спосіб зберігання даних, спершу HolyArrs робить бекап (резервну копію), а потім оновлює дані. Ти маєш побачити, що застосунок відкрився вже на новій версії.

Порада

Невдалий крок оновлення скасовується, а HolyArrs зупиняється на сторінці, яка пояснює, що сталося. Твої дані до оновлення лишаються як бекап.

Повернення до попередньої версії

HolyArrs не може змінити власний image, тому ти запускаєш старіший image, а HolyArrs повертає на місце старіші дані.

Обережно

Усе, що змінилося після оновлення, як-от нові тайтли, налаштування й історія, не потрапляє в бекап, зроблений перед оновленням.

1. Зміни тег image у файлі compose (або в docker run) на старіший, наприклад holyarrs/holyarrs:<older version>.
2. Виконай docker compose up -d.
3. Якщо оновлення не змінювало дані, стартує старіша версія. На цьому все.
4. Інакше старіша версія покаже сторінку замість застосунку. Натисни Put back the data from before the update (повернути на місце дані до оновлення).
5. Введи одноразовий код. Знайди його через docker logs <container>; шукай «one-time code».
6. HolyArrs перевіряє бекап, ставить його на місце й зупиняється. Ти маєш побачити, як контейнер знову стартує на цих даних завдяки політиці перезапуску. Якщо її немає, запусти контейнер сам.

Без цієї сторінки: docker exec <container> /holyarrs restore --pre-update, потім docker restart <container>. Без Docker: зупини HolyArrs, виконай holyarrs restore --pre-update, запусти його знову.

Нічого не видаляється. Новіші дані переходять у backups/before-restore-<time>/, тож ти можеш скасувати повернення. Якщо повертаєшся більш ніж на одну версію, HolyArrs бере найновіший бекап перед оновленням, який ця версія може прочитати.

Варіанти

Усе в Settings > Health checks (Налаштування > Перевірки справності). Останні три лежать у розширеній частині картки.

Параметр	За замовчуванням	Змінюй, коли
Check for a newer HolyArrs (шукати новіший HolyArrs)	Увімкнено	Ти не хочеш жодних запитів назовні
Check for updates every (шукати оновлення кожні)	щодня	Ти хочеш рідших перевірок: раз на 3, 7, 14 або 30 днів
Release feed (стрічка релізів)	Порожньо (версії HolyArrs)	Ти розміщуєш власну стрічку
Feed may be on the local network (стрічка може бути в локальній мережі)	Вимкнено	Твоя стрічка в твоїй власній мережі
Include test versions (like 1.2.0-rc1) (враховувати тестові версії, як-от 1.2.0-rc1)	Вимкнено	Ти хочеш отримувати повідомлення про тестові версії

Якщо не працює

Ознака: “The last check did not work.” Причина: на сервері немає інтернету, або твоя власна стрічка в локальній мережі. Рішення: перевір доступ до інтернету або ввімкни Feed may be on the local network.

Ознака: стрічка релізів не зберігається. Причина: в адресі є ім’я, пароль, ?query або #fragment, або адреса не починається з http:// чи https://. Рішення: прибери ці частини.

Ознака: оновлення зупинилося через брак місця на диску. Причина: немає місця для копії та оновлення. Рішення: звільни місце там, де лежить тека конфігурації, і запусти знову.

Ознака: сторінка повернення відхиляє твій код. Причина: старий код або 10 неправильних кодів від останнього запуску. Рішення: скопіюй код із найновішого рядка лога. Після 10 хибних спроб перезапусти контейнер і використай новий код.

Відкладені функції

У цій версії деякі функції за замовчуванням вимкнено. Вмикай їх на власний ризик. Поки функцію відкладено, її сторінки та пункти меню приховані, її маршрути API відповідають “not found”, а її завдання не виконуються. Дані, які ти для неї зберіг, лишаються.

Щоб увімкнути функцію, додай її перемикач у HOLYARRS_FLAGS через кому й перезапусти контейнер:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Щоб вимкнути, прибери назву й перезапусти. Приховані параметри повертаються, коли ти вмикаєш функцію знову.

Перемикач	Функція
plex_watchlists	Списки перегляду Plex перетворюються на запити
row_title_stats	Статистика тайтлів у рядах Explore (огляд) у Appearance (вигляд)
trakt_lists	Ключ Trakt, списки Trakt і відгуки Trakt. Списки TMDB лишаються ввімкненими
alert_channels_more	Сповіщення в Telegram, ntfy, Gotify, Pushover і webhook. Discord та електронна пошта лишаються ввімкненими
subtitle_sites	Сайти субтитрів і пошук субтитрів. Мова субтитрів лишається ввімкненою
emby_signin	Вхід через Emby. Оновлення бібліотеки Emby працює далі
go_back	Панель Go back (повернутися назад) на сторінці Status. Кроки з розділу Повернення до попередньої версії працюють і без неї

Нічого не змінилося після додавання перемикача? Перевір написання (малі літери, підкреслення) і перезапусти контейнер, а не лише сторінку.

Для досвідчених

Що надсилає перевірка

Один запит до api.github.com по найновішу версію, лише з User-Agent: HolyArrs/<version>. Без облікового запису, ключа чи списку медіа. Коли перевірку вимкнено, запитів немає зовсім.

Остання відповідь зберігається, тож перезапуск не запускає перевірку раніше строку. Одна перевірка чекає щонайбільше 15 с, читає щонайбільше 512 KB і проходить щонайбільше 3 перенаправлення, ніколи не перемикаючись між http і https. Посилання на нотатки до версії з’являється лише тоді, коли воно веде на сторінки версій HolyArrs на GitHub; інакше версія показується простим текстом.

Release feed приймає відповідь про версію у стилі GitHub, список версій, будь-який JSON із полем version або простий текст із номером версії. Адреси метаданих хмари завжди відхиляються. Тестова версія вважається давнішою за звичайну.

Бекап перед оновленням

Перш ніж змінити збережені дані, HolyArrs:

1. Перевіряє, чи є місце для копії та оновлення. Якщо ні, нічого не змінюється. Щоб пропустити перевірку, задай HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Копіює кожну базу даних у backups, перевіряє копію й записує поруч файл sha256. Після 3 невдалих копіювань нічого не змінюється.
3. Виконує кожен крок оновлення окремо й перевіряє його. Невдалий крок скасовується; завершені кроки лишаються. Запусти ту саму версію знову, щоб продовжити з невдалого кроку з тією самою копією.

Після першого вдалого запуску копія стає файлом holyarrs-backup-pre-update-<time>.zip з описом на кшталт “before updating from 1.1.0 to 1.2.0”. Вона з’являється в Settings > Backups (Налаштування > Бекапи) і в holyarrs restore --list. Зберігаються 3 найновіші; розклад бекапів їх ніколи не прибирає. Нове встановлення або оновлення, що не чіпає дані, не створює жодної.

Пов’язане

• Бекапи
• Перевірки справності
• Розділи й безпечний режим