====== Audio Book Shelf ======

[[https://www.audiobookshelf.org|AudioBookShelf]] is a //Self-hosted audiobook and podcast server//.

===== Installation =====

It is possible to install ABS on bare-metal. They provide prebuilt packages for Debian, Redhat/CentOS and NixOS. But i am on Gentoo, so i decided against downloading a //deb// or an //rpm// package but go the containers way instead.

As usual, you need to create the **audiobookshelf** user but be careful to assign it to the **media** group so that it can access all the audiobooks and podcasts of your collection,:
<code bash>
useradd -d /data/daemons/audiobookshelf -m -g media audiobookshelf
</code>

Then, as user **audiobookshelf**, create the following docker compose yaml (see [[https://www.audiobookshelf.org/docs#docker-compose-install|here]]):
<file - docker-compose.yml>
version: "3.7"
services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    ports:
      - 13378:80
    volumes:
      - /data/Audiobooks/:/audiobooks
      - /data/Podcasts:/podcasts
      - /data/daemons/audiobookshelf/config:/config
      - /data/Metadata:/metadata
    environment:
      - TZ=Europe/Rome
</file>

Set a proper port (13378)for your needs, one that is free from all your other services.
Double check the various volumes to point to your media collection properly. Also set your TimeZone (TZ) appropriately.

Now ensure your folders do exist:
<code bash>
mkdir /data/Podcasts
mkdir /data/Audiobooks
mkdir /data/Metadata
chown audiobookshelf:media -R /data/Podcasts /data/Audiobooks /data/Metadata
su - audiobookshelf
mkdir config
</code>

And then pull the images:
<code bash>
su - audiobookshelf
podman compose pull
</code>

===== Reverse Proxy =====

[[https://github.com/advplyr/audiobookshelf#reverse-proxy-set-up|This]] page is a collection of reverse proxy setups for AudioBookShelf.

This is my recomended one for NGINX:
<file - audiobookshelf.conf>
server {
        server_name podcast.gardiol.org;
        listen 8443 ssl; # external access
        listen 443 ssl; # internal access

        access_log /var/log/nginx/podcast.gardiol.org_access_log main;
        error_log /var/log/nginx/podcast.gardiol.org_error_log info;

        location / {
                     proxy_set_header X-Forwarded-For    $proxy_add_x_forwarded_for;
                     proxy_set_header  X-Forwarded-Proto $scheme;
                     proxy_set_header  Host              $host;
                     proxy_set_header Upgrade            $http_upgrade;
                     proxy_set_header Connection         "upgrade";

                     proxy_http_version                  1.1;

                     proxy_pass                          http://127.0.0.1:13378;
                     proxy_redirect                      http:// https://;
                   }

        include org.certbot.conf;
}
</file>

Unfortunately AudioBookShelf at this time does not support yet sub-paths, so you will need to host it on a subdomain.

===== Autostart =====

To start it, and set it up on boot, as usual follow my indications [[gentoo:containers|Using Containers on Gentoo]], so link the **user-containers** init script:
<code>
ln -s /etc/init.d/user-containers /etc/init.d/user-containers.audiobookshelf
</code>

and create the following config file:
<file - /etc/conf.d/user-containers.audiobookshelf>
USER=audiobookshelf
DESCRIPTION="The audiobooks and podcast server"
</file>

Add the service to the default runlevel and start it now:
<code bash>
rc-update add user-containers.audiobookshelf default
rc-service user-containers.audiobookshelf start
</code>

===== Upgrade =====

Since it's using pdoman, stop the service then, as user **audiobookshelf**, run:
<code bash>
podman compose pull
</code>

and restart the service.