Installer ABM

La base de données est un fichier SQLite dans /config, donc il n’y a aucun service de base de données à mettre en place.

Il te faut :

• Docker avec Compose
• Un dossier pour ta bibliothèque de livres audio
• Le dossier où ton client de téléchargement met les téléchargements terminés
• Un dossier pour les données d’ABM

Installation

1. Crée un fichier compose. Enregistre ceci sous le nom 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

2. Fais-le pointer vers tes dossiers. Remplace la partie gauche de chaque volume par un vrai dossier sur ta machine. Ne touche pas à la partie droite.

   Chemin sur l’hôte	Chemin dans le conteneur	Ce qu’on y met
   /path/to/library	/audiobooks	Ta bibliothèque de livres audio. Obligatoire.
   /path/to/downloads	/downloads	Là où ton client de téléchargement met les téléchargements terminés. Obligatoire.
   /path/to/config	/config	La base de données SQLite, les sauvegardes, les journaux, les corbeilles et le secret généré de l’app. Garde-le précieusement.

3. Démarre-le. Lance ceci depuis le dossier qui contient le fichier compose :

   docker compose up -d

4. Ouvre-le. Va sur http://your-server:5173. À la première visite, l’app te guide pour créer un identifiant.

Les téléchargements sont dans un autre conteneur ?

Si ton client de téléchargement tourne dans son propre conteneur, son dossier de téléchargements doit être le même dossier que celui qu’ABM voit comme /downloads. Si les chemins diffèrent, ajoute une correspondance de chemin distant dans Settings > Download Clients.

Premier lancement

Règle ton fuseau horaire avec TIMEZONE dans le fichier compose. Ensuite, dans Settings, ajoute un dossier racine dans Media Management, un indexeur dans Indexers et un client de téléchargement dans Download Clients. Les variables d’environnement et les reverse proxies sont expliqués dans Configuration.

Compiler depuis les sources

Pour construire l’image toi-même, clone le dépôt, remplace la ligne image: par build: . et lance :

docker compose up -d --build

Autres façons d’installer

Pour l’instant, Docker est la seule façon de l’installer. Des installations natives sont prévues, pour qu’ABM puisse tourner là où tu héberges déjà tes services :

Plateforme	Prévu sous forme de
Linux	Un paquet natif et un service
Windows	Un installeur .exe
macOS	Une app native
Kubernetes	Un déploiement sur cluster
Unraid	Un modèle Community Apps
Proxmox	Un script d’installation LXC

Rien de tout ça n’existe encore. Chacune apparaîtra sur la page Mises à jour quand elle sortira.

Mettre à jour

Récupère la nouvelle image et recrée le conteneur. La page Mises à jour liste ce qui a changé dans chaque version.

ABM est en alpha

Sauvegarde /config avant de mettre à jour, et jette d’abord un œil aux notes de mise à jour.

Quelque chose ne va pas ?

• La page ne se charge pas. Vérifie la redirection de port dans ton fichier compose, puis lance docker logs audiobook-manager.
• Les modifications sont refusées depuis mon domaine. ABM refuse les modifications venant d’une adresse par laquelle on ne le joint pas. Fais d’abord en sorte que ton proxy transmette l’en-tête Host d’origine. Si ça ne suffit pas, ajoute ton domaine dans CORS Allowed Domains dans Settings > General (c’est un réglage avancé, donc active Show Advanced) et redémarre ABM. Voir Dépannage.
• Les téléchargements se terminent mais ne sont jamais importés. Vérifie la correspondance des dossiers dans l’astuce ci-dessus.