# Complete *arr Media Automation

> Full media automation with Sonarr, Radarr, Prowlarr, and download clients.

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

## Overview

Sonarr, Radarr, and Prowlarr form the core of modern media automation, representing the evolution of self-hosted media management that began with early tools like SickBeard and CouchPotato. Sonarr handles TV show monitoring and acquisition, automatically tracking new episodes across RSS feeds and integrating with both Usenet and BitTorrent sources. Radarr provides identical functionality for movies, while Prowlarr serves as the centralized indexer manager that synchronizes tracker and indexer configurations across all *arr applications. This stack represents years of community-driven development focused on reliability, extensive customization options, and robust metadata handling. Prowlarr eliminates the traditional pain point of manually configuring indexers in each application, instead providing a single management interface that pushes configurations to connected services. When combined with qBittorrent as the download client and Jellyfin as the media server, this creates a complete pipeline from content discovery to streaming. The integration allows for automatic quality upgrades, failed download handling, and intelligent file organization that maintains clean library structures. This particular combination offers privacy-focused alternatives to commercial services - Jellyfin provides tracking-free streaming while qBittorrent offers advanced bandwidth management and RSS automation features. Home media enthusiasts and privacy-conscious users benefit most from this stack, particularly those managing large libraries across multiple content types. The system excels in environments where content needs to be automatically acquired, organized, and made available across multiple devices without relying on external services or subscriptions.

## Features

- Centralized indexer management through Prowlarr with automatic sync to all connected *arr applications
- Automatic TV episode and movie monitoring with customizable quality profiles and upgrade paths
- Failed download handling and automatic re-searching when downloads fail or are of poor quality
- Calendar view integration showing upcoming releases and monitoring status across all content types
- Hardware-accelerated transcoding in Jellyfin with support for Intel QuickSync, NVIDIA NVENC, and AMD VCE
- Advanced torrent management in qBittorrent with RSS automation, sequential downloading, and bandwidth scheduling
- Comprehensive metadata fetching from TheTVDB, TheMovieDB, and MusicBrainz with automatic artwork and subtitle handling
- List integration supporting IMDb watchlists, Trakt lists, and custom import sources for bulk content addition

## Use cases

- Home media server operators wanting to automate TV show and movie acquisition from multiple sources
- Cord-cutters seeking to replace cable television with automated content delivery and streaming
- Media collectors managing large libraries requiring consistent naming, organization, and quality standards
- Privacy-focused users avoiding commercial streaming services while maintaining equivalent convenience
- Multi-user households needing centralized media management with individual user profiles and parental controls
- Remote media access scenarios where content needs to be automatically acquired and available for streaming anywhere
- Bandwidth-conscious environments requiring scheduled downloads and quality management to control data usage

## Prerequisites

- Minimum 2GB RAM total (512MB each for Sonarr/Radarr, 256MB for Prowlarr, 1GB+ for Jellyfin with transcoding)
- At least 20GB free storage for application data plus adequate space for media libraries and download staging
- Valid indexer accounts for Usenet providers or private torrent trackers to populate Prowlarr configurations
- Basic understanding of media file formats, quality profiles, and torrent/Usenet concepts
- Network configuration knowledge for port forwarding if accessing services remotely or optimizing torrent connectivity
- Familiarity with file permissions and user/group management for proper media file access across containers

## docker-compose.yml

```yaml
services:
  prowlarr:
    image: linuxserver/prowlarr:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - prowlarr_config:/config
    ports:
      - "9696:9696"
    networks:
      - arr_net

  sonarr:
    image: linuxserver/sonarr:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - sonarr_config:/config
      - /media/tv:/tv
      - /media/downloads:/downloads
    ports:
      - "8989:8989"
    networks:
      - arr_net

  radarr:
    image: linuxserver/radarr:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - radarr_config:/config
      - /media/movies:/movies
      - /media/downloads:/downloads
    ports:
      - "7878:7878"
    networks:
      - arr_net

  lidarr:
    image: linuxserver/lidarr:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - lidarr_config:/config
      - /media/music:/music
      - /media/downloads:/downloads
    ports:
      - "8686:8686"
    networks:
      - arr_net

  readarr:
    image: linuxserver/readarr:develop
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - readarr_config:/config
      - /media/books:/books
      - /media/downloads:/downloads
    ports:
      - "8787:8787"
    networks:
      - arr_net

  qbittorrent:
    image: linuxserver/qbittorrent:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - WEBUI_PORT=8081
    volumes:
      - qbit_config:/config
      - /media/downloads:/downloads
    ports:
      - "8081:8081"
      - "6881:6881"
      - "6881:6881/udp"
    networks:
      - arr_net

  jellyfin:
    image: jellyfin/jellyfin:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - jellyfin_config:/config
      - jellyfin_cache:/cache
      - /media/tv:/media/tv:ro
      - /media/movies:/media/movies:ro
      - /media/music:/media/music:ro
    ports:
      - "8096:8096"
    networks:
      - arr_net

volumes:
  prowlarr_config:
  sonarr_config:
  radarr_config:
  lidarr_config:
  readarr_config:
  qbit_config:
  jellyfin_config:
  jellyfin_cache:

networks:
  arr_net:
```

## .env

```bash
# *arr Media Stack
# Update /media paths to your media directories

# Prowlarr at http://localhost:9696
# Sonarr at http://localhost:8989
# Radarr at http://localhost:7878
# Lidarr at http://localhost:8686
# Readarr at http://localhost:8787
# qBittorrent at http://localhost:8081
# Jellyfin at http://localhost:8096
```

## Usage notes

- Configure Prowlarr first as indexer manager
- Connect *arr apps to Prowlarr
- qBittorrent for downloads
- Jellyfin for streaming
- Set correct media paths

## Troubleshooting

- Sonarr shows 'No indexers available' error: Configure indexers in Prowlarr first, then sync applications in Settings > Apps
- Downloads stuck in qBittorrent but not importing: Check that download and media paths match between services, ensure proper file permissions
- Jellyfin transcoding fails or shows codec errors: Verify hardware acceleration settings and ensure GPU drivers are properly passed to container
- Prowlarr indexer tests failing with authentication errors: Verify API keys and credentials, check if indexer requires specific user-agent strings
- Media files not appearing in Jellyfin after import: Trigger library scan manually, verify read permissions on media directories, check file naming conventions
- High CPU usage during peak hours: Implement download scheduling in qBittorrent, limit concurrent downloads, configure transcoding quality limits in Jellyfin

