Audiobookshelf

Audiobookshelf is a self-hosted audiobook and podcast server. This setup runs it with Podman Compose.

---

What the compose file does

• Service: audiobookshelf — single container from ghcr.io/advplyr/audiobookshelf:latest
• Port: 13378 → container port 80 (web UI and API)
• Volumes: Binds host paths for:
  • Audiobooks: /mnt/storage/jellyfin/media/audible → /audiobooks
  • Podcasts: /mnt/storage/audiobookshelf/podcasts → /podcasts
  • Metadata: /mnt/storage/audiobookshelf/metadata → /metadata
  • Config: /mnt/storage/audibookshelf/config → /config

(Note: there is a typo in the config path — audibookshelf vs audiobookshelf — ensure that directory exists on the host.)

---

Prerequisites

• Podman and Podman Compose installed
• Host directories created (and optionally populated):
  • /mnt/storage/audiobookshelf/podcasts
  • /mnt/storage/audiobookshelf/metadata
  • /mnt/storage/audibookshelf/config
  • Audiobooks under /mnt/storage/jellyfin/media/audible (or adjust the volume in the compose file)

---

How to use

1. Go to the project folder:

   cd audiobookshelf
   

2. Start the stack:

   podman-compose up -d
   

3. Open the web UI:
   In a browser: http://<your-host>:13378

4. First run:
   Create an admin user when prompted.

5. Stop the stack:

   podman-compose down
   

---

Useful commands

Action	Command
Start	podman-compose up -d
Stop	podman-compose down
View logs	podman-compose logs -f
Restart	podman-compose restart

---

Customization

• Change the host port by editing 13378:80 under ports (e.g. 8080:80).
• To use different host paths, edit the volumes section and create the directories on the host first.