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 (0.64.0, 2026-09-14), podman (0.64.0, 2026-09-14); Proxmox VM: docker (0.64.0, 2026-09-14), podman (0.64.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:
navidrome:
container_name: njorddeploy-navidrome
image: "deluan/navidrome:latest"
ports:
- "4533:4533"
environment:
- "ND_SCANSCHEDULE=1h"
- "ND_LOGLEVEL=info"
- "ND_SESSIONTIMEOUT=24h"
- "ND_BASEURL=nd_baseurl"
volumes:
- "./data/navidrome/data:/data"
- "./data/navidrome/music:/music:ro"
user: "0:0"
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 |
|---|---|---|
NAVIDROME_WEB_PORT |
4533 |
The port to access the Navidrome web interface. |
ND_SCANSCHEDULE |
1h |
How often Navidrome should scan your music library for changes (e.g., 1h, 24h, 1m). |
ND_LOGLEVEL |
info |
The logging level for Navidrome (e.g., debug, info, warn, error). |
ND_SESSIONTIMEOUT |
24h |
How long a user session remains active (e.g., 24h, 7d). |
ND_BASEURL |
*None* |
If Navidrome is behind a reverse proxy, set the base URL (e.g., /navidrome). Leave empty if not using a subpath. |
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.