---
title: audiobookshelf
description: Quick overview of audiobookshelf and setup
date: 2025-02-04
lastmod: 2025-02-04
author: wompmacho
showHero: false # needed to hide "hero banner"
---

## What is Audiobookshelf?

`Audiobookshelf` is a self-hosted, open-source server designed to manage and stream your personal audiobook and podcast collections. It acts as a private, web-based alternative to services like Audible, giving you full control over your media files. Key features include:

## Docker Compose Example

> [!IMPORTANT] Audiobookshelf requires a websocket connection.

``` yaml
# audiobookshelf - https://github.com/advplyr/audiobookshelf/blob/master/docker-compose.yml
---
version: "3.7"
services:
  audiobookshelf:
    container_name: audiobookshelf
    image: ghcr.io/advplyr/audiobookshelf:latest
    # ABS runs on port 13378 by default. If you want to change
    # the port, only change the external port, not the internal port
    ports:
      - 13378:80
    volumes:
      # These volumes are needed to keep your library persistent
      # and allow media to be accessed by the ABS server.
      # The path to the left of the colon is the path on your computer,
      # and the path to the right of the colon is where the data is
      # available to ABS in Docker.
      
      # You can change these media directories or add as many as you want
      - /mnt/store/MediaServer/Audio_Books:/audiobooks
      - /mnt/store/MediaServer/podcasts:/podcasts
      - /mnt/store/app/audiobookshelf/metadata:/metadata
      
      # The config directory needs to be on the same physical machine
      # you are running ABS on
      - /app/audiobookshelf/config:/config
    restart: unless-stopped
    # You can use the following environment variable to run the ABS
    # docker container as a specific user. You will need to change
    # the UID and GID to the correct values for your user.
    #environment:
    #  - user=1000:1000
```

