# Sonarr + Radarr Media Management

> Automated TV and movie management with Sonarr, Radarr, and Prowlarr.

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

## Overview

Sonarr is a PVR (Personal Video Recorder) application designed for Usenet and BitTorrent users who want to automate their TV show downloads and library management. Born from the need to replace aging solutions like SickBeard, Sonarr monitors RSS feeds for new episodes, automatically downloads them based on quality profiles, and organizes them into your media library with proper naming conventions. When combined with Radarr (the movie equivalent) and Prowlarr (the indexer manager), this trio forms the backbone of modern automated media management systems.

This three-component stack creates a powerful automation pipeline where Prowlarr manages all your torrent trackers and Usenet indexers in one central location, then syncs them to both Sonarr and Radarr. Instead of configuring the same 20+ indexers in each application separately, Prowlarr handles the indexer management while Sonarr focuses on TV show logic and Radarr handles movie-specific workflows. The applications communicate through APIs to coordinate downloads, avoid conflicts, and share quality profiles and naming conventions.

Home media enthusiasts, cord-cutters, and anyone building a personal media server will find this stack invaluable for maintaining large libraries without manual intervention. The combination eliminates the tedious process of manually searching for, downloading, and organizing media files while ensuring consistent quality and naming standards across your entire collection. This setup integrates perfectly with media servers like Plex, Jellyfin, or Emby to create a fully automated entertainment system.

## Features

- Automatic episode and movie monitoring with season pack handling and backlog management
- Centralized indexer management through Prowlarr with 500+ supported torrent trackers and Usenet indexers
- Quality profiles with custom formats for resolution, codec, and release group preferences
- Failed download handling with automatic blacklisting and retry logic
- Calendar integration showing upcoming releases and missing episodes across both TV and movies
- List integration with IMDb, Trakt, and other services for automatic library building
- Metadata fetching and artwork management for complete media information
- Cross-application API synchronization for indexer settings and search coordination

## Use cases

- Home media server automation for cord-cutters wanting to maintain large TV and movie libraries
- Plex or Jellyfin server backend management with automatic content acquisition and organization
- Private tracker and Usenet community members needing efficient ratio management and release monitoring
- Media archival projects requiring consistent naming, quality standards, and metadata
- Remote media server management where manual downloads aren't practical
- Multi-user household media systems with diverse content preferences and quality requirements
- Backup and redundancy systems for existing media collections with automatic replacement of corrupted files

## Prerequisites

- Minimum 1GB RAM total (512MB for Sonarr, 256MB for Radarr, 256MB for Prowlarr) with 2GB+ recommended for large libraries
- Docker and Docker Compose installed with ports 7878, 8989, and 9696 available
- Active Usenet provider accounts and/or private tracker memberships for content sources
- Download client like qBittorrent, Deluge, SABnzbd, or NZBGet running and accessible
- Sufficient storage space for downloads directory and separate TV/movies directories with proper filesystem permissions
- Basic understanding of quality profiles, release groups, and media naming conventions

## 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:
      - media-network

  sonarr:
    image: lscr.io/linuxserver/sonarr:latest
    container_name: sonarr
    restart: unless-stopped
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-UTC}
    volumes:
      - sonarr_config:/config
      - ${TV_PATH:-./tv}:/tv
      - ${DOWNLOADS_PATH:-./downloads}:/downloads
    ports:
      - "${SONARR_PORT:-8989}:8989"
    networks:
      - media-network

  radarr:
    image: lscr.io/linuxserver/radarr:latest
    container_name: radarr
    restart: unless-stopped
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-UTC}
    volumes:
      - radarr_config:/config
      - ${MOVIES_PATH:-./movies}:/movies
      - ${DOWNLOADS_PATH:-./downloads}:/downloads
    ports:
      - "${RADARR_PORT:-7878}:7878"
    networks:
      - media-network

volumes:
  prowlarr_config:
  sonarr_config:
  radarr_config:

networks:
  media-network:
    driver: bridge
```

## .env

```bash
# Media Management Stack
PROWLARR_PORT=9696
SONARR_PORT=8989
RADARR_PORT=7878
PUID=1000
PGID=1000
TZ=UTC
TV_PATH=./tv
MOVIES_PATH=./movies
DOWNLOADS_PATH=./downloads
```

## Usage notes

- Prowlarr at http://localhost:9696
- Sonarr at http://localhost:8989
- Radarr at http://localhost:7878
- Connect Prowlarr to Sonarr/Radarr first

## Troubleshooting

- Prowlarr indexers showing 'Unable to connect' errors: Verify indexer credentials and check if the site requires VPN or has IP restrictions
- Sonarr/Radarr not finding releases despite Prowlarr working: Ensure Prowlarr apps are properly configured with correct API keys and URLs
- Downloads stuck in queue with 'No suitable indexer found': Check that Prowlarr has synced indexers to the requesting app and categories match
- Permission denied errors when moving completed downloads: Verify PUID/PGID match the ownership of your media directories
- Failed imports with 'Path does not exist' errors: Ensure download client and *arr apps use identical Docker volume mappings for the downloads folder
- High memory usage and slow performance: Reduce RSS sync intervals, limit concurrent searches, and consider using SQLite optimization for large libraries

