Navidrome Music Server

Key Features

• Subsonic and OpenSubsonic API compatibility for use with dozens of existing mobile and desktop music clients
• Automatic music library scanning with configurable intervals and real-time file system watching
• Built-in audio transcoding with support for multiple codecs and bitrate conversion on-the-fly
• Smart playlists and favorites with support for importing existing M3U playlists
• Multi-user support with individual libraries, playlists, and listening statistics
• Last.fm scrobbling integration for tracking listening habits across platforms
• Responsive web interface with support for offline playback and queue management
• ReplayGain support for consistent volume levels across tracks and albums

Common Use Cases

• 1Personal music streaming server for accessing large FLAC collections from mobile devices
• 2Family music sharing with separate user accounts and parental controls
• 3Audiophile setups requiring lossless streaming with on-demand transcoding for mobile
• 4Home lab environments consolidating media services with existing NAS storage
• 5Small office background music systems with centralized library management
• 6Travel and remote access to personal music collections via VPN or reverse proxy
• 7Migration path from commercial streaming services while maintaining mobile app compatibility

Prerequisites

• Docker and Docker Compose installed with at least 512MB available RAM
• Music library organized in a directory structure accessible to Docker containers
• Port 4533 available for the Navidrome web interface and API access
• Basic understanding of file permissions and user/group IDs for media access
• Network access configuration if planning to use external Subsonic clients
• Sufficient disk space for transcoding cache and database storage

docker-compose.yml

1services: 
2  navidrome: 
3    image: deluan/navidrome:latest
4    container_name: navidrome
5    restart: unless-stopped
6    user: "${PUID:-1000}:${PGID:-1000}"
7    ports: 
8      - "${NAVIDROME_PORT:-4533}:4533"
9    environment: 
10      ND_SCANSCHEDULE: ${SCAN_SCHEDULE:-1h}
11      ND_LOGLEVEL: info
12      ND_SESSIONTIMEOUT: 24h
13      ND_BASEURL: ""
14    volumes: 
15      - navidrome_data:/data
16      - ${MUSIC_PATH:-./music}:/music:ro
17    networks: 
18      - media-network
19
20volumes: 
21  navidrome_data: 
22
23networks: 
24  media-network: 
25    driver: bridge

.env Template

1# Navidrome Music Server
2NAVIDROME_PORT=4533
3PUID=1000
4PGID=1000
5MUSIC_PATH=./music
6SCAN_SCHEDULE=1h

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  navidrome:
5    image: deluan/navidrome:latest
6    container_name: navidrome
7    restart: unless-stopped
8    user: "${PUID:-1000}:${PGID:-1000}"
9    ports:
10      - "${NAVIDROME_PORT:-4533}:4533"
11    environment:
12      ND_SCANSCHEDULE: ${SCAN_SCHEDULE:-1h}
13      ND_LOGLEVEL: info
14      ND_SESSIONTIMEOUT: 24h
15      ND_BASEURL: ""
16    volumes:
17      - navidrome_data:/data
18      - ${MUSIC_PATH:-./music}:/music:ro
19    networks:
20      - media-network
21
22volumes:
23  navidrome_data:
24
25networks:
26  media-network:
27    driver: bridge
28EOF
29
30# 2. Create the .env file
31cat > .env << 'EOF'
32# Navidrome Music Server
33NAVIDROME_PORT=4533
34PUID=1000
35PGID=1000
36MUSIC_PATH=./music
37SCAN_SCHEDULE=1h
38EOF
39
40# 3. Start the services
41docker compose up -d
42
43# 4. View logs
44docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/navidrome-music-server/run | bash

Troubleshooting