Why this Configuration?
- True Data Sovereignty: 100% GDPR-compliant on-premises deployment. You own your configuration and data without vendor lock-in.
- Hardware Agnostic: Optimized and verified across low-power ARM64 SBCs (Raspberry Pi 5) and x86_64 hypervisors (Proxmox VE LXC & VM).
- Engine Freedom: Tested and supported under standard Docker Engine and unprivileged rootless Podman.
- Platform Verification: Tested on Proxmox LXC: docker (2.36.0, 2026-09-14), podman (2.36.0, 2026-09-14); Proxmox VM: docker (2.36.0, 2026-09-14), podman (2.36.0, 2026-09-14).
Quick Start (Standalone Docker Compose)
The snippet below is immediately ready to run in any standard Docker or Podman environment:
services:
audiobookshelf:
image: ghcr.io/advplyr/audiobookshelf:latest
container_name: njorddeploy-audiobookshelf
ports:
- "13378:80"
volumes:
- "./data/audiobookshelf/audiobooks:/audiobooks"
- "./data/audiobookshelf/podcasts:/podcasts"
- "./data/audiobookshelf/metadata:/metadata"
- "./data/audiobookshelf/config:/config"
environment:
- "PUID=1000"
- "PGID=1000"
- "TZ=Europe/Amsterdam"
restart: unless-stopped
networks:
- njorddeploy_net
networks:
njorddeploy_net:
Start the service directly via the command line: docker compose up -d
Configuration & Environment Variables
Key configuration parameters and defaults derived from the NjordDeploy component template:
| Variable | Default Value | Description |
|---|---|---|
AUDIOBOOKSHELF_PORT |
13378 |
The host port for the Audiobookshelf web interface. |
AUDIOBOOKSHELF_PUID |
1000 |
The User ID (PUID) for the container process. Set to 0 for root or match your host user's PUID for file permissions. |
AUDIOBOOKSHELF_PGID |
1000 |
The Group ID (PGID) for the container process. Set to 0 for root or match your host user's PGID for file permissions. |
AUDIOBOOKSHELF_AUDIOBOOKS_DIR |
/opt/njorddeploy/data/audiobookshelf/audiobooks |
Host path where your audiobook files are stored and accessible by Audiobookshelf. |
AUDIOBOOKSHELF_PODCASTS_DIR |
/opt/njorddeploy/data/audiobookshelf/podcasts |
Host path where your podcast files are stored and accessible by Audiobookshelf. |
AUDIOBOOKSHELF_METADATA_DIR |
/opt/njorddeploy/data/audiobookshelf/metadata |
Host path to store Audiobookshelf's metadata. |
AUDIOBOOKSHELF_CONFIG_DIR |
/opt/njorddeploy/data/audiobookshelf/config |
Host path to store Audiobookshelf's configuration files. |
Ecosystem & Enterprise Integration
- Reverse Proxy Ingress Ready: Pre-configured for Caddy, Traefik, or Nginx Proxy Manager with automatic Let's Encrypt TLS certificates.
- Zero-Trust Mesh VPN: Seamless integration with WireGuard or Tailscale/Headscale mesh networks for secure remote administration.
- Transactional State Backups: Ready for point-in-time database dumps and container-safe persistent volume freezing.
Effortless Management with NjordDeploy
Deploy, monitor, and update this service with a single click on your own hardware via the NjordDeploy Configurator.