servarr

name	servarr
description	Deploy, configure, and manage the full media stack — Sonarr, Radarr, Lidarr, Prowlarr, Plex, Tautulli, Overseerr, qBittorrent, Jackett, Bazarr, Recyclarr. Use when setting up media automation, quality profiles, indexers, Docker stacks, or managing a media server. Triggers on mentions of Sonarr, Radarr, Lidarr, Prowlarr, Plex, Tautulli, Overseerr, Jackett, *arr, servarr, media library, quality profiles, TRaSH Guides, media server, NAS.
allowed-tools	Read, Write, Edit, Glob, Grep, Bash, WebFetch

Servarr

Expert at deploying and managing the complete media automation stack.

Overview

The media stack follows a pipeline: Acquire → Organize → Serve → Request

• Prowlarr — Unified indexer manager, syncs to all *arr apps (port 9696)
• Sonarr — TV show monitoring and download automation (port 8989)
• Radarr — Movie monitoring and download automation (port 7878)
• Lidarr — Music collection management (port 8686)
• qBittorrent — Download client for torrents (port 8080)
• Bazarr — Automatic subtitle downloads (port 6767)
• Recyclarr — Sync TRaSH Guides quality profiles (CLI)
• Jackett — Indexer proxy, alternative to Prowlarr (port 9117)
• Plex — Media server for playback and transcoding (port 32400)
• Tautulli — Plex monitoring, analytics, and notifications (port 8181)
• Overseerr — User request management → triggers acquisition (port 5055)

Quick Start

# docker-compose.yml (minimal stack)
services:
  sonarr:
    image: lscr.io/linuxserver/sonarr:latest
    ports: ["8989:8989"]
    volumes: ["/path/to/data:/data", "./config/sonarr:/config"]
    environment: &env { PUID: "1000", PGID: "1000", TZ: "America/New_York" }
  radarr:
    image: lscr.io/linuxserver/radarr:latest
    ports: ["7878:7878"]
    volumes: ["/path/to/data:/data", "./config/radarr:/config"]
    environment: *env
  prowlarr:
    image: lscr.io/linuxserver/prowlarr:latest
    ports: ["9696:9696"]
    volumes: ["./config/prowlarr:/config"]
    environment: *env

API Pattern

All *arr apps use the same authentication and API style:

curl -H "X-Api-Key: YOUR_API_KEY" http://localhost:PORT/api/v3/ENDPOINT

API keys are found in each app under Settings → General → Security.

Core Concepts

Quality Profiles — Define acceptable release qualities (720p, 1080p, 4K). Use Recyclarr + TRaSH Guides for optimized defaults.

Root Folders — Where media files are stored. Use a shared /data mount for hardlinks.

Indexers — Configured centrally in Prowlarr, synced to all apps automatically.

Download Clients — qBittorrent/SABnzbd configured in each app under Settings → Download Clients.

Remote Path Mappings — Translate paths between apps when running on different hosts or containers.

Documentation

• Stack Overview — Architecture and data flow
• Docker Compose Setup — Full deployment templates
• Sonarr — Overview (settings, installation, FAQ, system)
• Radarr — Overview (settings, installation, FAQ, quick start)
• Lidarr — Overview (installation, troubleshooting)
• Prowlarr — Overview (installation, FAQ, indexers)
• Plex — Media server setup and library management
• Tautulli — Plex monitoring, analytics, notifications, API
• Overseerr — Request management
• Jackett — Indexer proxy setup and configuration
• qBittorrent — Download client configuration
• Bazarr — Subtitle management
• Quality Profiles — TRaSH Guides best practices
• Recyclarr Config — Recyclarr setup and guide configs
• Hardlinks Guide — TRaSH folder structure for instant moves
• API Reference — Shared API v3 patterns
• Troubleshooting — Common issues and fixes
• Remote Management — Laptop→NAS patterns

Common Workflows

Wire up the full stack

1. Deploy Docker Compose → 2. Configure Prowlarr indexers → 3. Add Sonarr/Radarr/Lidarr as apps in Prowlarr → 4. Set qBittorrent as download client in each app → 5. Add root folders → 6. Run Recyclarr for quality profiles → 7. Point Plex at media folders → 8. Set up Overseerr with Sonarr/Radarr

Add a movie via API

curl -X POST -H "X-Api-Key: $RADARR_KEY" -H "Content-Type: application/json" \
  http://localhost:7878/api/v3/movie \
  -d '{"tmdbId": 123, "qualityProfileId": 1, "rootFolderPath": "/data/movies", "monitored": true, "addOptions": {"searchForMovie": true}}'

Upstream Sources

• Servarr Wiki: https://wiki.servarr.com
• TRaSH Guides: https://trash-guides.info
• GitHub: Sonarr/Sonarr, Radarr/Radarr, Lidarr/Lidarr, Prowlarr/Prowlarr

Sync & Update

When user runs sync: fetch latest from upstream, update docs/. When user runs diff: compare current vs upstream, report changes.