Установка сервера

Сервер Antresol — один исполняемый файл с веб-интерфейсом внутри. Нужен компьютер или NAS, который включён, когда вы смотрите, и ffmpeg.

Docker (рекомендуется)

docker run -d --name antresol --restart unless-stopped \
  -p 8420:8420 \
  -v /путь/к/config:/config \
  -v /путь/к/медиатеке:/media \
  -e VAULT_MEDIA_ROOT=/media \
  ghcr.io/antresol-app/antresol-server:latest

Образ для linux/amd64 и linux/arm64, ffmpeg уже внутри.

Готовый файл

Скачайте архив для своей системы на странице выпусков (Linux x86-64 и ARM64, macOS Apple Silicon и Intel), установите ffmpeg и запустите:

VAULT_DATA_DIR=~/antresol/config VAULT_MEDIA_ROOT=~/antresol ./antresol-server

На macOS файл пока не подписан: перед первым запуском выполните xattr -d com.apple.quarantine antresol-server.

Первый запуск

Откройте http://<адрес-компьютера>:8420 в браузере и создайте администратора.

Разложите файлы по этим папкам внутри VAULT_MEDIA_ROOT (в Docker — внутри папки, подключённой как /media, например /путь/к/медиатеке/media/movies/):

Папка	Что
`media/movies/`	фильмы, одна папка на фильм
`media/series/`	сериалы: `Название/Season 01/…S01E01…`
`media/music/`	музыка: `Исполнитель/Альбом/`
`media/books/ebooks/`	книги EPUB, FB2, MOBI/AZW3, PDF
`media/books/audiobooks/`	аудиокниги, одна папка на книгу
`media/books/manga/`	комиксы и манга CBZ

Создайте профили для семьи. Детским профилям задайте возрастное ограничение.
Установите приложение Antresol на iPhone, iPad или Mac и введите адрес сервера.

Основные настройки

`VAULT_DATA_DIR`	база и настройки сервера
`VAULT_MEDIA_ROOT`	корень медиатеки
`VAULT_LISTEN`	адрес и порт, по умолчанию `:8420`
`VAULT_PUBLIC_URL`	https-адрес сервера в интернете, если он есть
`VAULT_TMDB_KEY`	ключ The Movie Database для обложек и описаний (необязательно)

Для доступа из интернета используйте https через обратный прокси или VPN (например, Tailscale). Добавляйте в медиатеку только файлы, на которые у вас есть права.

Лицензии сторонних компонентов — в файле THIRD_PARTY_LICENSES.md в каждом архиве.