# Lidarr

> Music collection manager for Usenet and BitTorrent.

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

## Overview

Lidarr is an automated music collection manager that monitors, downloads, and organizes your music library from Usenet and BitTorrent sources. Originally forked from Sonarr in 2017, Lidarr focuses specifically on music acquisition and management, using MusicBrainz database integration to maintain accurate metadata and proper file organization. The application continuously monitors for new releases from your favorite artists and automatically downloads them when they become available through configured indexers.

This Docker stack leverages the LinuxServer.io image to provide a containerized Lidarr instance with proper user permissions and timezone handling. The configuration maps essential directories for music storage and download monitoring, while exposing the web interface on port 8686. The setup allows Lidarr to integrate with download clients like SABnzbd, NZBGet, qBittorrent, or Deluge, and works particularly well when combined with Prowlarr for centralized indexer management.

This stack is ideal for music enthusiasts, audiophiles, and home media server administrators who want to automate their music collection management. The containerized approach ensures consistent deployment across different environments while maintaining proper file permissions and providing easy backup and migration capabilities through Docker volumes.

## Features

- MusicBrainz integration for accurate artist and album metadata matching
- Automatic monitoring of artist discographies with customizable metadata profiles
- Support for multiple audio quality profiles and format preferences
- Calendar view showing upcoming album releases from monitored artists
- Manual and automatic search capabilities across configured indexers
- Import existing music libraries with duplicate detection and quality upgrading
- Comprehensive activity history and blacklist management for failed downloads
- REST API for integration with mobile apps and third-party tools

## Use cases

- Home media server automation for personal music collection management
- Audiophile setups requiring specific quality profiles and format preferences
- Music library organization and cleanup with metadata standardization
- Automated monitoring of favorite artists for new album releases
- Integration with existing *arr stack ecosystems alongside Sonarr and Radarr
- Headless music acquisition for remote servers and NAS devices
- Quality upgrading workflows for replacing lower-quality existing files

## Prerequisites

- Minimum 512MB RAM allocated to the container for stable operation
- Port 8686 available for web interface access
- Existing download client (SABnzbd, NZBGet, qBittorrent, etc.) configured
- Usenet provider account and/or BitTorrent indexer access for content sources
- Basic understanding of metadata profiles and quality settings
- Sufficient storage space for both downloads and organized music library

## docker-compose.yml

```yaml
services:
  lidarr:
    image: linuxserver/lidarr:latest
    container_name: lidarr
    restart: unless-stopped
    environment:
      PUID: 1000
      PGID: 1000
      TZ: UTC
    volumes:
      - lidarr_config:/config
      - /path/to/music:/music
      - /path/to/downloads:/downloads
    ports:
      - "8686:8686"

volumes:
  lidarr_config:
```

## .env

```bash
# Configure your music and download paths
```

## Usage notes

- Docs: https://wiki.servarr.com/lidarr
- Access at http://localhost:8686 - no default credentials
- Add indexers: Settings > Indexers (or use Prowlarr)
- Configure download client: Settings > Download Clients
- Add root folder for music library before importing artists
- Metadata profiles control what releases to grab (official, unofficial)

## Troubleshooting

- Import fails with 'No files found are eligible for import': Verify file permissions match PUID/PGID and check supported audio formats in media management settings
- Artist search returns no results: Confirm indexers are properly configured and responding in Settings > Indexers, test connectivity
- Downloads stuck in queue: Check download client connection settings and ensure download paths are properly mapped between Lidarr and client
- Metadata fetching errors: Verify MusicBrainz connectivity and consider adjusting API rate limiting in general settings
- Permission denied errors on file operations: Ensure PUID/PGID environment variables match host user ownership of mounted volumes
- Web interface not accessible: Confirm port 8686 mapping and check container logs for binding errors or startup issues

