Audiobookshelf
Audiobookshelf is a self-hosted audiobook and podcast server.
Enable audiobookshelf in the Container Map. The playbook will:
- Create the config and metadata folders in
<hmsdocker_apps_path>/audiobookshelf/ - Create
AudiobooksandPodcastsfolders in your library folder, next toMoviesandTV_Shows - Run Audiobookshelf as the
hmsdocker_container_uid/hmsdocker_container_giduser
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.
Folders
Section titled “Folders”| 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 |
Adding libraries
Section titled “Adding libraries”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.
Homepage widget
Section titled “Homepage widget”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.