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
| Tool | Open Source | Free Tier | Monthly Cost |
|---|---|---|---|
| Audible | No | No | From $14.95/mo |
| Pocketcasts | No | Limited | From $3.99/mo |
| Overcast | No | Yes | From $9.99/yr |
Installation
Architecture
- Deployment: Single
audiobookshelfdeployment in theaudiobookshelfnamespace - 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-configandaudiobookshelf-metadata(Longhorn-encrypted); NFS PV for the audio library (TrueNAS) - Backups: k8up
Schedulebacks 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
- Image:
ghcr.io/advplyr/audiobookshelf:2.33.1@sha256:a4a5841bba093d81e5f4ad1eaedb4da3fda6dbb2528c552349da50ad1f7ae708