Папки

Настройте папки один раз, чтобы готовые загрузки попадали в Медиатеку мгновенно и без второй копии.

В примере из раздела Установка папки /movies, /tv, /music и /downloads смонтированы по отдельности. Так работает, но каждый импорт — это полное копирование. На этой странице четыре точки монтирования заменяются одной общей родительской папкой. Это необязательно.

Правило

Держите загрузки и медиафайлы в одной родительской папке, на одном диске, и смонтируйте эту папку в HolyArrs и в загрузчик по одному и тому же пути.

Жёсткая ссылка (hardlink) — это второе имя того же файла. Она не занимает лишнего места и создаётся мгновенно. Она работает только внутри одной файловой системы, а Docker считает каждую точку монтирования отдельной, поэтому при раздельном монтировании файл приходится копировать целиком.

/srv/data                  mounted as /data in HolyArrs and the downloader
├── downloads
│   ├── torrents
│   └── usenet
└── media
    ├── movies
    ├── tv
    └── music

Настройка

1. Создайте папки на хосте:

   mkdir -p /srv/data/downloads/{torrents,usenet} /srv/data/media/{movies,tv,music}

2. Дайте пользователю из PUID права на запись:

   chown -R 1000:1000 /srv/data

3. Смонтируйте родительскую папку в HolyArrs: - /srv/data:/data.

4. Точно так же смонтируйте её в загрузчик: - /srv/data:/data, а папкой сохранения в нём укажите /data/downloads/torrents или /data/downloads/usenet.

5. В HolyArrs при первом запуске укажите /data/media/movies, /data/media/tv и /data/media/music как папки Медиатеки.

   В Settings > Library folders (Настройки > Папки Медиатеки) не должно быть предупреждения No hardlink (нет жёсткой ссылки).

Осторожно

Отдельные сетевые папки NAS или наборы данных внутри /srv/data — это отдельные файловые системы. Между ними файлы всё равно копируются. Используйте папки внутри одной сетевой папки.

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

Раздельное монтирование

/movies, /tv, /music и /downloads как четыре точки монтирования тоже работают. Тогда каждый импорт копирует файл: это дольше и занимает вдвое больше места, пока загрузчик не удалит свою копию.

Загрузчик в другом контейнере с другими путями

Если загрузчик видит папку под другим именем, заполните у него Downloader’s path (путь у загрузчика) и HolyArrs’ path (путь у HolyArrs) в Settings > Downloaders (Настройки > Загрузчики), например /data/torrents и /downloads. Если пути совпадают, сопоставление не нужно.

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

Что вы видите	Причина	Решение
No hardlink у папки Медиатеки	Загрузки и медиафайлы лежат на разных точках монтирования или в разных файловых системах	Смонтируйте одну родительскую папку, как описано выше
Read only (только для чтения) или Missing (не найдена)	Путь неверный, или у PUID нет прав на запись	Укажите путь внутри контейнера; исправьте владельца
Папка не найдена	Вы ввели путь на хосте	Введите путь в контейнере, например /data/media/movies
При импорте сказано, что путь не разрешён	Папка загрузок не входит в известные места	Задайте HOLYARRS_SAVE_PATH или добавьте её в Settings > Library folders > Extra import folders (дополнительные папки импорта)

Для опытных

Что проверяет проверка папки

Проверка	Результат при неудаче
Папка существует	Missing (папка не используется)
HolyArrs может записать тестовый файл	Read only (папка не используется)
Жёсткая ссылка из папки каждого активного загрузчика	No hardlink (предупреждение, при импорте файлы копируются)
Свободно не меньше 100 МБ	Заметка о нехватке места

Тестовые файлы удаляются после проверки. Check again (проверить ещё раз) запускает её заново.

Правила для папок Медиатеки

• Путь должен существовать, вести к папке и быть полным.
• Папка не может лежать внутри другой папки Медиатеки или содержать её. Каждый путь используется один раз.
• Rename (переименовать) меняет только отображаемое название. Remove (убрать) оставляет все файлы на месте и не сработает, пока папкой пользуются тайтлы.
• Extra import folders: по одному полному пути в строке, не больше 32. Целый диск, например / или C:\, не принимается. Менять список может только Владелец или Администратор, вошедший по паролю.
• Ручной импорт разрешает также папки Медиатеки, HOLYARRS_SAVE_PATH и сторону HolyArrs в каждом сопоставлении путей загрузчика. Пути с .., пути сетевых папок и ссылки, ведущие наружу, не принимаются.

См. также

• Установка
• Папки Медиатеки
• Платформы