Self-Hosting Your Digital Library: A Guide to Calibre-Web and Audiobookshelf on Docker

The Shift Toward Digital Self-Reliance

In an era dominated by subscription-based cloud services, the concept of digital ownership has shifted significantly. When you purchase an ebook or an audiobook from mainstream platforms, you rarely own the file; instead, you license the right to access it under specific, revocable terms. For professionals, researchers, and avid bibliophiles who rely on an uninterrupted access to information, this dependency presents a distinct operational risk.

Self-hosting your digital library mitigates this risk entirely. By deploying your own server infrastructure, you retain 100% data ownership, eliminate recurring subscription fees, and gain the freedom to customize your metadata, user access controls, and streaming quality. This technical guide provides a step-by-step blueprint for building an enterprise-grade personal library ecosystem using two industry-standard open-source applications: Calibre-Web for electronic publications and Audiobookshelf for spoken-word audio content, both orchestrated seamlessly via Docker.

Architecture Overview: Why This Stack?

An optimal self-hosted library requires a clear separation of concerns. Ebooks demand robust metadata tagging, full-text searching, and cross-device syncing for reading progress. Audiobooks require media streaming capabilities, precise chapter navigation, and offline caching via dedicated mobile applications. Trying to force a single application to handle both mediums often results in a compromised user experience.

• Docker & Docker Compose: Provides lightweight containerization, ensuring that our library software remains isolated, highly portable, and trivial to update or back up without conflicting with the host operating system dependencies.
• Calibre-Web: Acts as a sleek, modern web interface for your existing Calibre database. It allows users to browse, search, and read formats like EPUB, PDF, and MOBI directly in the browser or sync them smoothly to e-readers such as Kobo and Kindle.
• Audiobookshelf: A premier self-hosted audio server designed explicitly for audiobooks and podcasts. It features multi-user support, custom metadata scraping from public databases, and native mobile apps for iOS and Android that handle offline playback state syncing perfectly.

Prerequisites and System Requirements

Before initiating the deployment, ensure your host environment meets the following baseline criteria:

1. A server running a Linux distribution (Ubuntu Server 22.04 LTS or Debian 12 recommended). A Raspberry Pi 4/5 or a network-attached storage (NAS) device with container support is also highly viable.
2. Docker Engine (version 20.10+) and Docker Compose v2 installed.
3. A structured directory tree on your storage volume to organize configurations and media assets.
4. A domain name or a local DNS solution if you intend to expose these services via a reverse proxy (e.g., Nginx Proxy Manager, Traefik) with SSL certificates.

Security Note: Never expose raw HTTP ports directly to the public internet. Always secure external traffic using an encrypted reverse proxy or a secure overlay network like Tailscale or WireGuard.

Step-by-Step Deployment Guide

1. Organizing the Directory Structure

To maintain long-term maintainability, establish a standardized directory layout on your host system. Execute the following commands in your terminal to create the necessary paths:

mkdir -p ~/media-server/config/calibre-web
mkdir -p ~/media-server/config/audiobookshelf
mkdir -p ~/media-server/data/books
mkdir -p ~/media-server/data/audiobooks
mkdir -p ~/media-server/data/podcasts

Note on Calibre-Web: Unlike standalone systems, Calibre-Web requires a valid, pre-existing Calibre database file named metadata.db inside your books directory. If you do not have one, you can create a blank library using the desktop version of Calibre and copy the resulting metadata.db file directly into the ~/media-server/data/books folder.

2. Constructing the Docker Compose Configuration

Create a centralized configuration file named docker-compose.yml in your ~/media-server directory. This file defines how our containers interact, their persistent storage volumes, and network exposure ports.

version: '3.8'

services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PID=1000
      - PGID=1000
      - TZ=Asia/Ho_Chi_Minh
      - DOCKER_MODS=linuxserver/mods:universal-calibre # Enables ebook conversion utilities
    volumes:
      - ~/media-server/config/calibre-web:/config
      - ~/media-server/data/books:/books
    ports:
      - 8083:8083
    restart: unless-stopped

  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    environment:
      - AUDIOBOOKSHELF_UID=1000
      - AUDIOBOOKSHELF_GID=1000
      - TZ=Asia/Ho_Chi_Minh
    volumes:
      - ~/media-server/config/audiobookshelf:/config
      - ~/media-server/data/audiobooks:/audiobooks
      - ~/media-server/data/podcasts:/podcasts
      - ~/media-server/metadata/audiobookshelf:/metadata
    ports:
      - 13378:80
    restart: unless-stopped

Replace the PUID, PGID, and TZ environmental values with your system's specific user ID, group ID, and local timezone to prevent permission mismatches on your storage drives.

3. Initializing the Containers

With your directory structure verified and the compose file configured, launch the services concurrently using the following terminal command:

cd ~/media-server && docker compose up -d

Verify that both containers are running optimally by executing docker compose ps. The output should reflect that both services are healthy and forwarding to ports 8083 and 13378 respectively.

Initial Configuration and Optimization

Configuring Calibre-Web

Navigate to http://your-server-ip:8083 using your preferred browser. Upon your initial visit, Calibre-Web will prompt you to input the absolute path to your Calibre database. Enter /books (matching the internal container directory mapping we configured in our compose file).

Log in using the default administrative credentials: Username: admin | Password: admin123. Change these credentials immediately within the profile settings panel to protect your server. To enable in-browser reading and metadata editing, navigate to Admin Utilities -> Edit Basic Configuration, and check the boxes next to 'Enable Uploads', 'Enable Anonymous Browsing' (if desired), and your specific reading viewer defaults.

Configuring Audiobookshelf

Access your new streaming platform via http://your-server-ip:13378. Follow the on-screen initialization wizard to establish your root admin account. Once logged into the primary dashboard, you must declare your libraries:

1. Click 'Add Library' and select 'Audiobooks' as the media type.
2. Map the directory path to /audiobooks.
3. Under the 'Advanced' tab, choose your preferred metadata providers (such as Audible, Open Library, or Google Books) to automate cover art and author bio retrieval.
4. Repeat the process for the /podcasts directory if you wish to aggregate audio feeds.

Advanced Optimizations: Client Syncing and OPDS

The true utility of a self-hosted media repository lies in its portability and client integrations. Both applications support standard interoperability frameworks that maximize device compatibility.

OPDS Feeds for E-Readers

Calibre-Web features an integrated Open Publication Distribution System (OPDS) catalog server. This protocol allows modern mobile reading applications—such as Marvin, KyBook, or KOReader—to query, browse, and download items directly from your server without utilizing a web browser. The OPDS feed endpoint can typically be found at http://your-server-ip:8083/opds and requires user authentication.

Native Audiobookshelf Mobility

Unlike standard music servers, Audiobookshelf treats audio tracks as singular continuous narratives. Downloading the official Audiobookshelf app from the Apple App Store or Google Play Store allows you to securely hook back into your home server URL. The mobile application continuously caches audio files ahead of playback, tracks chapters natively, and features a highly precise sleep timer, ensuring an ecosystem parity that rivals Audible.

Conclusion and Next Steps

By shifting away from restrictive corporate platforms and implementing your own Docker-managed digital library, you secure your intellectual assets for the long haul. Calibre-Web acts as a feature-rich, highly visual repository for text-based media, while Audiobookshelf bridges the gap for dynamic, multi-device audio consumption.

As next steps to mature your installation, consider integrating an automated reverse proxy with Let's Encrypt certificates to allow for secure, HTTPS-encrypted access from outside your home local network, and establish an automated cron job to periodically backup your /config and /metadata volumes to an offsite location.