Встановлення ABM

Один контейнер, три теки, одна команда. Ця сторінка і є вся інструкція зі встановлення.

Ще не випущеноЦі кроки встановлення запрацюють з першим випуском.

База даних це файл SQLite у /config, тож окремий сервіс бази даних налаштовувати не треба.

Тобі знадобиться:

Docker із Compose
Тека для твоєї бібліотеки аудіокнижок
Тека, у яку твій клієнт завантажень кладе завершені завантаження
Тека для власних даних ABM

Встановлення

Створи compose-файл. Збережи це як docker-compose.yml:

services:
  audiobook-manager:
    image: ghcr.io/sunbrolynk/audiobook-manager:latest
    container_name: audiobook-manager
    restart: unless-stopped
    ports:
      - "${PORT:-5173}:5173"
    environment:
      TIMEZONE: ${TIMEZONE:-UTC}
      LOCAL_NETWORKS: ${LOCAL_NETWORKS:-}
      TRUSTED_PROXIES: ${TRUSTED_PROXIES:-}
    volumes:
      - /path/to/library:/audiobooks
      - /path/to/downloads:/downloads
      - /path/to/config:/config

Вкажи свої теки. Заміни ліву частину кожного тому на справжню теку на своїй машині. Праву частину не чіпай.

Шлях на хості	Шлях у контейнері	Що там лежить
`/path/to/library`	`/audiobooks`	Твоя бібліотека аудіокнижок. Обов’язково.
`/path/to/downloads`	`/downloads`	Куди клієнт завантажень кладе завершені завантаження. Обов’язково.
`/path/to/config`	`/config`	База даних SQLite, резервні копії, журнали, кошики та згенерований секрет застосунку. Бережи її.

Запусти. Виконай це в теці з compose-файлом:
Terminal window
```
docker compose up -d
```
Відкрий. Перейди на http://your-server:5173. Під час першого відвідування ABM проведе тебе через налаштування логіна.

Перший запуск

Задай свій часовий пояс через TIMEZONE у compose-файлі. Потім у Settings додай кореневу теку в Media Management, індексатор в Indexers і клієнт завантажень у Download Clients. Про змінні середовища та зворотні проксі йдеться в розділі Конфігурація.

Збірка з вихідного коду

Щоб зібрати образ самому, склонуй репозиторій, заміни рядок image: на build: . і виконай:

docker compose up -d --build

Інші способи встановлення

Поки що єдиний шлях це Docker. Нативне встановлення в планах, щоб ABM міг працювати там, де ти вже тримаєш свої сервіси:

Платформа	Що буде
Linux	Нативний пакет і служба
Windows	Інсталятор `.exe`
macOS	Нативний застосунок
Kubernetes	Розгортання в кластері
Unraid	Шаблон для Community Apps
Proxmox	Скрипт встановлення в LXC

Жодного з них ще немає. Кожен з’явиться на сторінці Оновлення, щойно вийде.

Оновлення

Стягни новий образ і перествори контейнер. На сторінці Оновлення видно, що змінилося в кожному випуску.

Щось не так?

Сторінка не відкривається. Перевір прокидання порту в compose-файлі, потім виконай docker logs audiobook-manager.
Зміни з мого домену відхиляються. ABM відхиляє зміни з адреси, за якою його не відкривали. Спершу налаштуй проксі, щоб він передавав оригінальний заголовок Host. Якщо цього не досить, додай свій домен у CORS Allowed Domains у Settings > General (це розширений параметр, тож увімкни Show Advanced) і перезапусти ABM. Дивись Усунення несправностей.
Завантаження завершуються, але не імпортуються. Перевір відповідність тек із підказки вище.