# Music Server Stack

> Navidrome music server with Lidarr for music management and Deemix downloader

- Category: Media & Entertainment
- Difficulty: intermediate
- Components: navidrome, lidarr, deemix
- Tags: navidrome, music, lidarr, streaming, subsonic
- Source: https://docker.recipes/media/music-server-stack

## Overview

Navidrome is a modern, web-based music server that implements the Subsonic API, allowing you to stream your personal music collection from anywhere with a sleek web interface and mobile app compatibility. Originally created as a lightweight alternative to heavier music servers like Plex or Jellyfin, Navidrome focuses exclusively on audio streaming with features like on-the-fly transcoding, playlist management, and support for various audio formats including FLAC, MP3, and OGG. This comprehensive music stack combines Navidrome with Lidarr for automated music library management, Prowlarr for indexer coordination, and qBittorrent as the download client to create a fully automated music acquisition and streaming system. The integration allows Lidarr to automatically search for, download, and organize music releases while Navidrome provides the streaming interface for your growing collection. This setup is ideal for music enthusiasts who want to maintain a high-quality personal music library with automatic metadata management, album art fetching, and the ability to stream their collection to any device through Subsonic-compatible mobile apps like DSub, Symfonium, or Ultrasonic.

## Features

- Subsonic/Airsonic API compatibility for seamless integration with dozens of mobile music apps
- Real-time music library scanning with configurable intervals for automatic detection of new releases
- On-the-fly audio transcoding to reduce bandwidth usage on mobile connections
- Automatic music metadata fetching and organization through Lidarr's MusicBrainz integration
- Smart playlist generation and management with support for various criteria and filters
- Multi-user support with individual libraries, playlists, and playback history
- Automated quality upgrading when better releases become available through Lidarr monitoring
- Cross-platform web interface with responsive design for desktop and mobile browsers

## Use cases

- Personal music streaming server for audiophiles with large FLAC collections requiring quality preservation
- Family music sharing system with individual user accounts and personalized recommendations
- Remote music access for frequent travelers who want their full library available anywhere
- Automated music discovery and acquisition for users who want new releases from followed artists
- Replacement for discontinued services like Google Play Music with personal library control
- Home media center integration for whole-house audio streaming through various client devices
- Music collection digitization project with automated organization and metadata management

## Prerequisites

- Minimum 2GB RAM (4GB recommended for large libraries over 10,000 tracks)
- At least 20GB free disk space for application data plus storage for your music collection
- Port availability: 4533 (Navidrome), 8686 (Lidarr), 9696 (Prowlarr), 8080 (qBittorrent)
- Basic understanding of music file formats and quality profiles for Lidarr configuration
- Familiarity with BitTorrent indexers and music release naming conventions
- Network configuration knowledge for remote access setup and mobile app connectivity

## docker-compose.yml

```yaml
services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    restart: unless-stopped
    ports:
      - "${NAVIDROME_PORT:-4533}:4533"
    volumes:
      - ./navidrome/data:/data
      - ./music:/music:ro
    environment:
      - ND_SCANSCHEDULE=1h
      - ND_LOGLEVEL=info
      - ND_SESSIONTIMEOUT=24h
      - ND_BASEURL=

  lidarr:
    image: lscr.io/linuxserver/lidarr:latest
    container_name: lidarr
    restart: unless-stopped
    ports:
      - "${LIDARR_PORT:-8686}:8686"
    volumes:
      - ./lidarr/config:/config
      - ./music:/music
      - ./downloads:/downloads
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-UTC}

  prowlarr:
    image: lscr.io/linuxserver/prowlarr:latest
    container_name: prowlarr
    restart: unless-stopped
    ports:
      - "${PROWLARR_PORT:-9696}:9696"
    volumes:
      - ./prowlarr/config:/config
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-UTC}

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    restart: unless-stopped
    ports:
      - "${QBIT_PORT:-8080}:8080"
    volumes:
      - ./qbittorrent/config:/config
      - ./downloads:/downloads
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-UTC}
```

## .env

```bash
# Music Server Stack
NAVIDROME_PORT=4533
LIDARR_PORT=8686
PROWLARR_PORT=9696
QBIT_PORT=8080

# User/Group IDs
PUID=1000
PGID=1000
TZ=UTC
```

## Usage notes

- Navidrome at http://localhost:4533 (create account on first visit)
- Lidarr at http://localhost:8686 for music management
- Subsonic/Airsonic API compatible for mobile apps
- Configure Lidarr with Prowlarr indexers
- Music stored in ./music directory
- Supports DSub, play:Sub, Symfonium apps

## Troubleshooting

- Navidrome shows empty library after startup: Ensure the music directory contains properly tagged audio files and check scan logs for permission issues
- Lidarr cannot connect to qBittorrent: Verify qBittorrent web UI is enabled and check the connection settings in Lidarr's download client configuration
- Mobile apps cannot find Navidrome server: Confirm the Subsonic API is enabled and use the correct server URL format with /rest endpoint
- Music files not importing after download: Check file permissions match PUID/PGID settings and verify Lidarr's root folder configuration
- Prowlarr indexers failing to sync with Lidarr: Ensure both containers can communicate and check API key configuration in both applications
- Transcoding fails on mobile playback: Verify FFmpeg is properly installed in the Navidrome container and check transcoding settings for supported formats

