NAS, Synology і Unraid

Запусти HolyArrs на своєму NAS з правильними теками, власником і параметром перезапуску. Спершу прочитай Встановлення.

Перш ніж почати

• /config кладуть на локальний том або пул. Ніколи на мережевий ресурс.
• Медіа лежать в одній спільній теці, всередині якої downloads, movies, tv і music. Змонтуй кожну з них або один раз батьківську теку, щоб працювали hardlink (жорстке посилання). Див. Теки.

Налаштуй свій NAS

::tab[Synology]

1. У File Station створи docker/holyarrs/config.
2. Створи одну спільну теку media, всередині якої downloads, movies, tv і music.
3. У Container Manager відкрий Project > Create (проєкт > створити) і встав файл Compose зі сторінки Встановлення.
4. Задай томи /volume1/docker/holyarrs/config:/config, потім /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music і /volume1/media/downloads:/downloads.
5. Задай PUID і PGID свого користувача, часто це 1026 і 100. Перевір через SSH командою id <user>.
6. Дай цьому користувачу читання й запис у media: Control Panel > Shared Folder > Edit > Permissions (панель керування > спільна тека > змінити > права доступу).
7. Постав позначку Enable auto-restart (увімкнути автоперезапуск).
8. Відкрий http://your-server:6262. Ти маєш побачити майстер першого запуску. Додай /movies, /tv і /music як теки бібліотеки.

::tab[Unraid]

Шаблону Community Applications ще немає, тож додай контейнер вручну.

1. На вкладці Docker додай контейнер з образом HolyArrs.
2. Зістав порт 6262.
3. Зістав /config зі шляхом пулу, наприклад /mnt/<pool>/appdata/holyarrs. <pool> — це назва твого пулу. Не /mnt/user/appdata.
4. Зістав свої теки медіа з /movies, /tv, /music і /downloads, використовуючи шляхи дисків або пулів, наприклад /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music і /mnt/<pool>/media/downloads:/downloads.
5. Задай PUID=99, PGID=100 (це nobody:users в Unraid) і UMASK=022.
6. Увімкни автозапуск контейнера, щоб він перезапускався сам.
7. Відкрий http://your-server:6262. Ти маєш побачити майстер першого запуску.

::tab[QNAP]

1. Створи Container/holyarrs/config і один ресурс media, всередині якого downloads, movies, tv і music.
2. У Container Station відкрий Applications > Create (застосунки > створити) і встав файл Compose.
3. Використай /share/Container/holyarrs/config:/config, потім /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music і /share/media/downloads:/downloads.
4. Задай PUID і PGID власника ресурсу media.
5. Задай політику перезапуску unless-stopped.
6. Відкрий http://your-server:6262. Ти маєш побачити майстер першого запуску.

::tab[TrueNAS SCALE]

1. Створи 2 датасети: apps/holyarrs-config і media, а всередині media теки downloads, movies, tv і music.
2. У Apps додай власний застосунок з YAML, використавши файл Compose.
3. Використай /mnt/<pool>/apps/holyarrs-config:/config, потім /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music і /mnt/<pool>/media/downloads:/downloads.
4. Задай PUID і PGID власника датасету, часто це 568. Дай цьому користувачу доступ на запис в ACL датасету.
5. Задай політику перезапуску unless-stopped.
6. Відкрий http://your-server:6262. Ти маєш побачити майстер першого запуску.

На будь-якому NAS: дай користувачу PUID читання й запис у теці медіа на екрані прав доступу NAS; про теку конфігурації HolyArrs дбає сам. Увімкни автоперезапуск контейнера (політика Docker unless-stopped).

Щоб працювали hardlink, які не займають додаткового місця й завершуються миттєво, змонтуй одну теку медіа замість чотирьох і дай своєму завантажувачу те саме монтування за тим самим шляхом. Див. Теки медіа.

Варіанти

Окремі монтування

Монтувати /movies, /tv, /music і /downloads по одному можна, але тоді кожен імпорт стає повним копіюванням. Кожне монтування — окрема файлова система всередині контейнера, а hardlink не може перетинати файлові системи. Окремі ресурси чи датасети під одним батьківським теж копіюють. Settings > Library folders (налаштування > теки бібліотеки) попереджає, коли HolyArrs доводиться копіювати.

Дай дискам поспати

Ці завдання будять диски з медіа. Частоту їх запуску змінюй на сторінці Schedules (розклади).

Завдання	Що воно читає
Rescan the Library (пересканувати бібліотеку)	Кожну теку бібліотеки. Будить диски найбільше.
Check Library folders (перевірити теки бібліотеки)	Дані й вільне місце кожної теки. Перевірка запису та hardlink виконується лише під час запуску, при Run now (виконати зараз) і коли теки змінюються.
Look for missing subtitles (шукати відсутні субтитри), Look for better subtitles (шукати кращі субтитри)	Теку поруч із кожним відео.

• Поклади /config і теку завантажень на SSD або кеш-пул.
• Тримай 1 GB вільного на диску, де лежить /config. Менше — і з’явиться попередження про справність.
• В Unraid плагін Cache Directories тримає списки тек в оперативній пам’яті, тож сканування не чіпає диск.
• Імпорт, додавання й видалення чіпають диск, з яким працюють, коли відбуваються.
• Задай пересканування раз на 7 днів або вимкни. Тоді файли, які ти додав вручну, знаходяться лише коли натиснеш Run now біля Rescan the Library.
• Торент, що роздається, читає свій файл. Якщо він зв’язаний hardlink з твоєю бібліотекою, цей диск не засинає, доки роздача не припиниться.

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

Ознака	Причина	Рішення
Не запускається, називає шлях FUSE, мережевий ресурс або користувацький ресурс Unraid	/config не на локальному диску (в Unraid вказує на /mnt/user)	Перенеси /config на локальний диск або шлях пулу, наприклад /mnt/<pool>/appdata/holyarrs.
Лишається зупиненим після перезапуску чи відновлення	Автоперезапуск вимкнено	Увімкни його й запусти контейнер.
Імпорт завершується помилкою прав доступу	Користувач PUID не може писати в медіа	Дай йому читання й запис на екрані прав доступу NAS (у Synology: Control Panel > Shared Folder > Edit > Permissions).
Імпорт робить копії, а не hardlink	Завантаження й бібліотека на різних монтуваннях або дисках	Змонтуй одну спільну теку один раз, і в HolyArrs, і в завантажувачі.

Більше рішень: Усунення проблем.

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

Чому HolyArrs відхиляє деякі шляхи конфігурації

HolyArrs тримає свої бази даних у /config. Мережеві ресурси та шляхи FUSE можуть їх пошкодити, тому HolyArrs відмовляється запускатися на такому шляху й пояснює причину.

В Unraid /mnt/user — це шлях FUSE. Використай шлях пулу або зроби appdata ексклюзивним: увімкни Permit exclusive shares (дозволити ексклюзивні ресурси) у Settings > Global Share Settings (налаштування > глобальні налаштування ресурсів), потім у Shares > appdata (ресурси > appdata) задай основне сховище на одному пулі, а вторинне — none.

Шлях /config на пулі, якого не існує, потрапляє в оперативну пам’ять і втрачається після перезавантаження. HolyArrs відхиляє й це. Не використовуй /mnt/user і для медіа; hardlink через нього можуть не спрацювати.

Чому автоперезапуск важливий

Перезапуск із застосунку, безпечний режим і відновлення з бекапу зупиняють HolyArrs і чекають, що Docker запустить його знову. Без автоперезапуску він лишається зупиненим. Див. Розділи й безпечний режим.

Порт і оновлення

• Зістав порт 6262 лише з домашньою мережею. Прочитай Основи безпеки, перш ніж відкривати його для когось ззовні.
• Щоб оновитися, завантаж новий образ і створи контейнер заново. Твої дані лишаються в /config. Див. Оновлення.

Пов’язане

• Теки
• Теки бібліотеки
• Розклади