Automate Media Downloads for Your Plex Library
An automated media pipeline watches for new releases, downloads them, renames files to Plex naming conventions, organizes them into the correct folders, and triggers a Plex library scan — all without manual intervention. The core tools are Sonarr for TV shows, Radarr for movies, and a download client that handles the actual file transfers. This guide covers how to set up the complete automation stack.
The Automation Stack
A fully automated Plex media pipeline uses these components:
- Sonarr: Monitors TV shows. Searches for new episodes after they air, sends download requests to your download client, and imports completed files into your Plex TV library.
- Radarr: Same concept for movies. Monitors your movie wishlist and downloads when releases become available.
- Prowlarr: Manages indexers (sources) centrally. Instead of configuring indexers in both Sonarr and Radarr separately, Prowlarr syncs indexer configurations to all connected apps.
- Download client: Handles the actual file transfers. Common choices include qBittorrent, SABnzbd, and NZBGet.
- Plex: The final destination. Automated tools rename files and place them in Plex-compatible folder structures, then trigger a library scan.
Installation
Docker (Recommended)
Running the automation stack in Docker provides clean isolation, easy updates, and consistent configuration. Each tool runs in its own container:
- Use images from linuxserver.io — they are well-maintained and widely used in the Plex community.
- Map configuration volumes to persistent storage so settings survive container updates.
- Map media directories consistently across all containers — use the same path structure in Sonarr, Radarr, and your download client to enable hardlinking (which saves disk space by not duplicating files).
Native Installation
Sonarr, Radarr, and Prowlarr run natively on Windows, Linux, and macOS. Download installers from their official websites. The tools run as services and start automatically on boot.
Prowlarr Setup
Set up Prowlarr first — it feeds indexers to Sonarr and Radarr:
- Access Prowlarr's web interface (default port 9696).
- Add indexers that your download client supports. Each indexer represents a source of content listings.
- Connect Prowlarr to Sonarr and Radarr: in Prowlarr Settings, Apps, add each application with its URL and API key.
- Prowlarr automatically syncs your indexer list to both Sonarr and Radarr. When you add or remove an indexer in Prowlarr, the change propagates to all connected apps.
Sonarr Configuration
Connect to Download Client
- Go to Settings, Download Clients in Sonarr.
- Add your download client (qBittorrent, SABnzbd, etc.) with its URL, port, and credentials.
- Test the connection to verify Sonarr can communicate with the download client.
Root Folders
Tell Sonarr where your Plex TV library lives:
- Go to Settings, Media Management, Root Folders.
- Add the path to your TV show library (e.g., /media/tv/ or D:\Media\TV Shows\).
- This is where Sonarr places completed and renamed files.
Quality Profiles
Quality profiles control what Sonarr downloads. Configure profiles that match your Plex setup:
- HD-1080p: Preferred for most users. Downloads 1080p content in HEVC or H.264.
- Ultra-HD: Downloads 4K content. Only use this if your Plex clients support 4K direct play.
- Any: Downloads the best available quality. Good for rare content where you want anything you can get.
Set preferred words in quality profiles to favor specific attributes: prefer HEVC over H.264 for smaller files, prefer specific audio formats, or avoid specific release groups.
Adding TV Shows
- Search for a show by name in the Sonarr interface.
- Select the correct match from the results.
- Choose the quality profile, root folder, and whether to monitor future episodes, all episodes, or none.
- Sonarr begins monitoring the show. When a new episode airs, Sonarr searches for it and downloads it automatically.
Plex Integration
Connect Sonarr to Plex for automatic library updates:
- Go to Settings, Connect.
- Add Plex Media Server with your server URL and Plex authentication token.
- When Sonarr imports a new episode, it notifies Plex to scan the specific show directory. The new episode appears in Plex within seconds of import.
Radarr Configuration
Radarr follows the same pattern as Sonarr but for movies:
- Connect to your download client (same client Sonarr uses).
- Set the root folder to your Plex movie library path.
- Configure quality profiles — same concepts as Sonarr.
- Connect to Plex for automatic library scans.
- Add movies to your wishlist. Radarr searches for them and downloads when available.
Movie Discovery
Radarr includes lists that automatically add movies to your collection:
- IMDB lists: Import movies from IMDB watchlists or curated lists.
- TMDB lists: Popular movies, top rated, trending.
- Trakt lists: Community-curated lists and personal watchlists.
Lists run on a schedule — Radarr checks them periodically and adds new entries to your collection automatically.
Naming Conventions
Both Sonarr and Radarr rename downloaded files to match Plex naming conventions automatically. The default rename patterns produce Plex-compatible names, but verify the settings match your preferred style:
Sonarr Default
{Series Title} - S{season:00}E{episode:00} - {Episode Title}
Produces: Breaking Bad - S01E01 - Pilot.mkv
Radarr Default
{Movie Title} ({Release Year})
Produces: Inception (2010).mkv
Radarr also creates the movie folder automatically in the same format.
Hardlinking and Storage
When properly configured, Sonarr and Radarr use hardlinks instead of copying files. A hardlink creates a second filesystem reference to the same data — the file appears in both the download directory and the Plex library without using double the disk space.
Requirements for hardlinking:
- The download directory and library directory must be on the same filesystem (partition/volume).
- In Docker, both directories must be within the same volume mount.
- NTFS (Windows), ext4, XFS, and ZFS all support hardlinks. FAT32 and exFAT do not.
Monitoring and Maintenance
Activity Monitoring
Both Sonarr and Radarr show real-time download activity, upcoming releases, and import history in their web interfaces. Check these dashboards periodically to verify the automation is working.
Failed Downloads
Downloads can fail for various reasons — incomplete files, corrupt archives, or removed sources. Sonarr and Radarr automatically retry failed downloads by searching for alternative sources. Configure the retry limit and delay in Settings.
Disk Space
Monitor disk space carefully. Automated downloads fill storage quickly, especially with high-quality profiles. Configure:
- Download client to pause when disk space drops below a threshold.
- Sonarr and Radarr to check available space before starting downloads.
- Automatic cleanup of completed downloads in the download client after Sonarr/Radarr has imported them.
Security Considerations
- Set strong passwords on all web interfaces. By default, Sonarr and Radarr are accessible to anyone on your local network.
- Do not expose these tools directly to the internet without authentication. Use a VPN or reverse proxy with authentication if you need remote access.
- Keep all tools updated. Security patches are released regularly.
Troubleshooting
Downloads Complete But Do Not Appear in Plex
- Check Sonarr/Radarr Activity for import errors. The most common cause is a permissions issue — the tool cannot write to the library directory.
- Verify the Plex notification is configured in Settings, Connect.
- Check that the file was renamed and moved to the correct library path.
Wrong Quality Downloaded
- Review and adjust quality profiles. The preferred quality may not be available, causing a fallback to a lower tier.
- Check indexer results — if only low-quality sources are available from your indexers, the tool downloads the best it can find.
Duplicate Downloads
- Enable upgrade tracking in quality profiles. This allows Sonarr/Radarr to replace a lower-quality download with a higher-quality one when available, rather than downloading duplicates.