Skip to main content

Audiobookshelf

A self-hosted audiobook and podcast server.

About

Audiobookshelf is an open-source audiobook and podcast server with a web UI and mobile apps. It streams your personal audio library, tracks listening progress across devices, and supports metadata management. Self-hosting avoids subscription fees and keeps your library and listening history private.

AlternativeTo

Cloud Hosted

ToolOpen SourceFree TierMonthly Cost
AudibleNoNoFrom $14.95/mo
PocketcastsNoLimitedFrom $3.99/mo
OvercastNoYesFrom $9.99/yr

Installation

Architecture

  • Deployment: Single audiobookshelf deployment in the audiobookshelf namespace
  • Image: ghcr.io/advplyr/audiobookshelf:2.33.1 (digest-pinned)
  • Storage: Two Longhorn PVCs (audiobookshelf-config, audiobookshelf-metadata) for app data; NFS PV from TrueNAS for the audio library
  • Networking: ClusterIP service on port 80, HTTPRoute via internal gateway

Security

  • Runs as runAsUser: 10001, runAsNonRoot: true
  • allowPrivilegeEscalation: false, capabilities dropped
  • Longhorn PVCs encrypted at rest via SOPS-managed keys

Updates

Managed by Renovate. Image is digest-pinned (sha256:a4a584…).

Data Management

  • PVCs: audiobookshelf-config and audiobookshelf-metadata (Longhorn-encrypted); NFS PV for the audio library (TrueNAS)
  • Backups: k8up Schedule backs up both Longhorn PVCs to Hetzner S3 (workload-talos-audiobookshelf-*) via restic. No database — app uses its own file-based storage.

User Management

No OIDC or LDAP configured. User accounts managed internally through the Audiobookshelf web UI.

Configuration Management

  • Longhorn encryption keys from SOPS-encrypted secrets (audiobookshelf-config-longhorn, audiobookshelf-metadata-longhorn)
  • k8up S3 credentials and restic password from SOPS secrets

Administration

Usage

Access the web UI to manage your audiobook and podcast library. Upload or link audio files from the NFS share, track per-book and episode progress, and stream from any device. Mobile apps (iOS/Android) sync listening progress back to the server.

Metadata

Kubernetes Metadata
  • Image: ghcr.io/advplyr/audiobookshelf:2.33.1@sha256:a4a5841bba093d81e5f4ad1eaedb4da3fda6dbb2528c552349da50ad1f7ae708