Skip to content

Homelab - Podcast and Audiobook Server: Audiobookshelf


Audiobookshelf is a self-hosted server for podcasts and audiobooks, designed to make podcast searching, automatic update detection, and downloading, as well as seamless organization, a breeze.

Deployment (Docker Compose)

To get started, create a compose.yaml file and paste the following content:

version: "3.7"
    container_name: ${STACK_NAME}_app
      - ${APP_PORT}:80
      - ${STACK_DIR}/audiobooks:/audiobooks
      - ${STACK_DIR}/config:/config
      - ${STACK_DIR}/metadata:/metadata
      - ${DATA_DIR}:/podcasts
    restart: unless-stopped

(Optional) It's recommended to create a .env file in the same directory as compose.yaml and customize your environment variables. If you prefer not to use environment variables, you can directly customize your parameters within compose.yaml (e.g., replace ${STACK_NAME} with audiobookshelf).

STACK_DIR=xxx # Customize your project storage path, e.g., ./audiobookshelf
DATA_DIR=xxx # Customize your podcast storage path, e.g., ./podcast

# audiobookshelf
APP_PORT=xxxx # Customize the access port, ensuring it's not already in use

If you have a NAS (Network Attached Storage), you can also mount storage space from your NAS using the NFS protocol. This allows you to store your podcasts on the NAS to save server space. For details, refer to Mounting Synology NAS Hard Drive for Space Expansion on Linux (NFS).

Finally, in the directory where compose.yaml is located, execute the docker compose up -d command to start the orchestrated containers.

Configuration Notes

Mobile App: There are official apps available for both iOS and Android platforms, making it easy to access and use.

References and Acknowledgments

Original: This post is protected by CC BY-NC-SA 4.0 agreement, should be reproduced with attribution.

This post is translated using ChatGPT, please feedback if any omissions.