ConfigsApr 10, 2026·3 min read

Audiobookshelf — Self-Hosted Audiobook & Podcast Server

Audiobookshelf is an open-source audiobook and podcast server with progress sync, chapter navigation, mobile apps, and multi-user support — a self-hosted Audible alternative.

TL;DR
Audiobookshelf is a self-hosted server for audiobooks and podcasts with progress sync, chapters, and mobile apps.
§01

What it is

Audiobookshelf is an open-source audiobook and podcast server that you host yourself. It provides progress synchronization across devices, chapter navigation, mobile apps for iOS and Android, and multi-user support with individual libraries.

Audiobookshelf targets anyone with a personal audiobook or podcast collection who wants a self-hosted Audible alternative. It reads standard audio formats (MP3, M4A, M4B, FLAC) and automatically detects metadata, cover art, and chapter markers from files.

§02

How it saves time or tokens

Audiobookshelf eliminates the need for paid audiobook subscription services by organizing your existing collection into a browsable library with automatic metadata matching. Progress syncs across all devices, so you never lose your place. The built-in podcast downloader fetches new episodes automatically. Multi-user support means a single server handles an entire household without separate installations.

§03

How to use

  1. Deploy with Docker:
docker run -d --name audiobookshelf \
  -p 13378:80 \
  -v /path/to/audiobooks:/audiobooks \
  -v /path/to/podcasts:/podcasts \
  -v audiobookshelf-config:/config \
  -v audiobookshelf-metadata:/metadata \
  ghcr.io/advplyr/audiobookshelf:latest
  1. Open http://localhost:13378, create an admin account, and point it at your audiobook directories.
  1. Install the mobile app (iOS or Android) and connect to your server for on-the-go listening.
§04

Example

# docker-compose.yml for Audiobookshelf
services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    ports:
      - '13378:80'
    volumes:
      - /mnt/media/audiobooks:/audiobooks
      - /mnt/media/podcasts:/podcasts
      - abs-config:/config
      - abs-metadata:/metadata
    restart: unless-stopped

volumes:
  abs-config:
  abs-metadata:
§05

Related on TokRepo

This tool integrates with standard development workflows and requires minimal configuration to get started. It is available as open-source software with documentation and community support through the official repository. The project follows semantic versioning for stable releases.

For teams evaluating this tool, the key advantage is reducing manual work in repetitive tasks. The automation provided by the built-in features means less custom code to maintain and fewer integration points to manage. This translates directly to lower maintenance costs and faster iteration cycles.

§06

Common pitfalls

  • Audiobook files must be organized in a specific folder structure (Author/Book Title/) for automatic metadata matching; random file dumps will not be detected correctly.
  • The mobile apps require your server to be accessible over the network; for remote access, set up a reverse proxy with HTTPS rather than exposing the port directly.
  • Large audiobook libraries (1000+ titles) may take time for the initial metadata scan; let the first scan complete before making configuration changes.

Frequently Asked Questions

What audio formats does Audiobookshelf support?+

Audiobookshelf supports MP3, M4A, M4B, FLAC, OGG, WMA, and other common audio formats. M4B files with embedded chapters are fully supported, including chapter navigation in the player.

Does Audiobookshelf have mobile apps?+

Yes. Official apps are available for iOS and Android. They connect to your self-hosted server and sync listening progress, bookmarks, and library state across all devices.

Can multiple users share one Audiobookshelf server?+

Yes. Audiobookshelf supports multiple user accounts, each with individual progress tracking, library access controls, and listening statistics. An admin user manages accounts and server settings.

How does podcast support work?+

Audiobookshelf includes a podcast manager that subscribes to RSS feeds, downloads new episodes automatically, and tracks listening progress. Podcasts are managed in a separate library from audiobooks.

Is Audiobookshelf free?+

Yes. Audiobookshelf is open-source and free to use under the GPL-3.0 license. There are no subscriptions, no per-user fees, and no usage limits. You only need a server or NAS to host it.

Citations (3)
🙏

Source & Thanks

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets