# Lidarr Music Automation

> Automated music management with Lidarr and Prowlarr indexer.

- Category: Media & Entertainment
- Difficulty: intermediate
- Components: lidarr, prowlarr
- Tags: lidarr, music, automation, prowlarr, management
- Source: https://docker.recipes/media/lidarr-music-automation

## Overview

Lidarr is an automated music collection manager that monitors multiple RSS feeds for new releases from your favorite artists and automatically downloads, sorts, and renames music files. Originally forked from Sonarr in 2017, Lidarr has evolved into the premier music automation solution for managing digital music libraries. It integrates with MusicBrainz for metadata accuracy, supports quality profiles for different formats, and can handle both album and artist monitoring with sophisticated release detection. This stack combines Lidarr with Prowlarr, creating a powerful music automation pipeline where Prowlarr serves as the centralized indexer manager feeding torrent trackers and Usenet indexers directly into Lidarr. Prowlarr eliminates the need to manually configure indexers in Lidarr by providing automatic synchronization of over 500 supported indexers, complete with search testing and statistics tracking. This combination is ideal for music enthusiasts running home media servers, audiophiles maintaining extensive digital collections, and anyone seeking to automate the tedious process of music discovery and library management. The integration provides superior indexer management compared to standalone solutions, with Prowlarr's native *arr app sync ensuring new indexers are automatically available in Lidarr without manual intervention.

## Features

- MusicBrainz integration for accurate album and artist metadata with automatic tagging
- Quality profiles supporting multiple audio formats from MP3 to FLAC with bitrate preferences
- Artist and album monitoring with intelligent release detection and upgrade capabilities
- Prowlarr's 500+ indexer support with automatic sync to Lidarr eliminating manual configuration
- Cardigann definition support in Prowlarr for custom torrent tracker integration
- Calendar view showing upcoming releases from monitored artists with release date tracking
- Prowlarr search testing and indexer health monitoring with failure notifications
- Automatic music file organization with customizable naming schemes and folder structures

## Use cases

- Home media server operators building comprehensive music libraries with automated collection
- Audiophiles maintaining high-quality FLAC collections with automatic upgrades from lossy formats
- Music enthusiasts tracking new releases from hundreds of artists without manual searching
- Private tracker users leveraging Prowlarr's extensive tracker support for rare music discovery
- Digital music collectors consolidating indexer management across multiple music sources
- Plex or Jellyfin server administrators automating music library expansion and maintenance
- Musicians and DJs building reference libraries with automated organization and quality control

## Prerequisites

- Minimum 512MB RAM for both containers with 1GB+ recommended for large music libraries
- Available ports 8686 (Lidarr) and 9696 (Prowlarr) or alternative port configuration
- Storage paths configured for music library and downloads directory with proper permissions
- PUID/PGID values matching your system's user permissions for file access
- Basic understanding of music release types, quality profiles, and indexer concepts
- Access to torrent trackers or Usenet indexers for content acquisition

## docker-compose.yml

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

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

volumes:
  prowlarr_config:
  lidarr_config:

networks:
  music-network:
    driver: bridge
```

## .env

```bash
# Lidarr Music Stack
LIDARR_PORT=8686
PROWLARR_PORT=9696
PUID=1000
PGID=1000
TZ=UTC
MUSIC_PATH=./music
DOWNLOADS_PATH=./downloads
```

## Usage notes

- Lidarr at http://localhost:8686
- Prowlarr at http://localhost:9696
- Configure indexers in Prowlarr first
- Sync Prowlarr to Lidarr

## Troubleshooting

- Lidarr shows no search results: Verify Prowlarr indexers are synced and responding in Prowlarr's test search
- Permission denied errors on music files: Ensure PUID/PGID environment variables match your system user ID
- Prowlarr sync failing to Lidarr: Check that Lidarr is accessible at the configured URL and API key is valid
- Albums not importing after download: Verify download client configuration and folder permissions in both containers
- MusicBrainz metadata lookup failures: Check network connectivity and consider MusicBrainz rate limiting during peak usage
- Port 8686 or 9696 already in use: Modify LIDARR_PORT or PROWLARR_PORT environment variables to use alternative ports

