Skip to content

Audiobookshelf

Audiobookshelf is a self-hosted audiobook and podcast server.

Enable audiobookshelf in the Container Map. The playbook will:

  1. Create the config and metadata folders in <hmsdocker_apps_path>/audiobookshelf/
  2. Create Audiobooks and Podcasts folders in your library folder, next to Movies and TV_Shows
  3. Run Audiobookshelf as the hmsdocker_container_uid/hmsdocker_container_gid user

Audiobookshelf is then available at audiobookshelf.<domain> through Traefik, or on port 13378 if ports are exposed. The first time you open it, you create the root (admin) user.

Folder Path on the host Path inside the container
Database <hmsdocker_apps_path>/audiobookshelf/config /config
Covers, cache, logs, backups <hmsdocker_apps_path>/audiobookshelf/metadata /metadata
Media share <hmsdocker_mount_path> /data

Libraries are added in the web UI under Settings > Libraries. Use these folders (replace media_data and _library if you changed hmsdocker_primary_mount_name or hmsdocker_library_folder_name):

  • Audiobooks: /data/media_data/_library/Audiobooks
  • Podcasts: /data/media_data/_library/Podcasts

Audiobookshelf needs write access to these folders to download podcast episodes, and for features such as embedding metadata, merging files into an .m4b, and saving covers next to the media. On a local media share, the playbook creates them owned by the hmsdocker_container_uid/hmsdocker_container_gid user. On a NAS share, or if the folders already existed, make sure they are writable by that user, as with the rest of your media share. If you add audiobookshelf to hmsdocker_readonly_media_containers, these features stop working.

To show library stats in Homepage, create an API key in Audiobookshelf under Settings > API Keys (as an admin), then set it in inventory/group_vars/all/homepage_api_keys.yml:

hmsdocker_homepage_audiobookshelf_key: <your API key>

Run the playbook again to apply it.