Build an Automated Media Pipeline for Plex
Published 2026-10-16 · PlexBeam
A fully automated media pipeline handles everything from content discovery to Plex library update without manual intervention. New TV episodes download within minutes of airing. Movies appear in your library as soon as they become available. Files are renamed, organized, and quality-checked automatically. This guide covers how to architect and deploy a production-quality media pipeline.
Pipeline Architecture
The automated pipeline has four layers, each handled by a dedicated tool:
- Indexer management (Prowlarr): Centralizes source configuration. Syncs indexers to all downstream tools so you manage sources in one place.
- Content management (Sonarr + Radarr): Monitors wishlists, searches for content, and manages quality upgrades. Sonarr handles TV; Radarr handles movies.
- Download management (qBittorrent or SABnzbd): Handles file transfers, speed limits, and category routing.
- Library management (Plex): Receives organized files and makes them available for streaming. Notified by Sonarr and Radarr when new content arrives.
Installation Order
Install components in dependency order:
- Download client first. Both Sonarr and Radarr need a configured download client before they can function.
- Prowlarr second. Configure indexers here before connecting to Sonarr and Radarr.
- Sonarr and Radarr third. Connect them to the download client and Prowlarr.
- Plex integration last. Connect Sonarr and Radarr to Plex for automatic library updates.
Docker Compose
The entire stack runs well in Docker Compose with all services defined in a single compose file. Key considerations:
- Use a shared volume structure so all containers see the same paths. This enables hardlinking between download and library directories.
- Use a common user/group ID (PUID/PGID) across all containers to avoid permission conflicts.
- Place configuration volumes on fast storage (SSD). Database operations in Sonarr and Radarr benefit from SSD speed.
Volume and Path Strategy
The most critical design decision: how you structure volumes determines whether hardlinking works. Hardlinking saves significant disk space by creating a second reference to the same file data instead of copying.
Recommended Structure
Use a single parent directory that contains both downloads and library:
/data/downloads/— where the download client places completed files/data/media/movies/— Plex movie library/data/media/tv/— Plex TV library
Mount /data as a single volume in all containers. Because downloads and library are on the same filesystem, hardlinking works. The file exists once on disk but appears in both locations.
What Breaks Hardlinking
- Downloads and library on different filesystems or partitions.
- Downloads and library in different Docker volume mounts that point to different host paths.
- NAS storage where downloads happen locally but library is on the NAS (different filesystems).
When hardlinking is not possible, Sonarr and Radarr copy the file — using double the disk space until the download client removes the original.
Prowlarr Configuration
- Access the web UI at port 9696.
- Add indexers that your download client supports.
- Add Sonarr and Radarr as applications in Settings, Apps. Provide each app's URL and API key.
- Prowlarr syncs indexers to both apps. When you add or remove an indexer in Prowlarr, it propagates automatically.
Sonarr Configuration
Download Client
Settings, Download Clients — add your download client with its URL and credentials. Set a category name (e.g., sonarr-tv) so downloads are organized in the client.
Root Folders
Settings, Media Management — add the TV library root path (e.g., /data/media/tv/).
Quality Profiles
Define what quality levels are acceptable:
- Set a cutoff quality — Sonarr stops upgrading once a file meets this quality level.
- Order preferred qualities from best to acceptable. Sonarr downloads the best available and upgrades when better becomes available.
- Use custom formats to prefer specific attributes: HEVC over H.264, specific audio codecs, or release groups known for quality.
Plex Notification
Settings, Connect — add Plex Media Server. When Sonarr imports a file, it tells Plex to scan the specific show directory. The new episode appears in Plex within seconds.
Radarr Configuration
Radarr follows the same pattern as Sonarr with movie-specific features:
- Root folder points to the movie library path.
- Quality profiles define movie quality targets (1080p, 4K, etc.).
- Lists automate movie discovery — import from IMDB watchlists, Trakt trending, TMDB popular, or curated lists.
- Plex notification configured the same as Sonarr.
Download Client Configuration
qBittorrent
- Set the default save path to the downloads directory within the shared volume structure.
- Create categories matching what Sonarr and Radarr expect (sonarr-tv, radarr-movies).
- Configure speed limits during peak hours to avoid impacting Plex streaming.
- Set automatic torrent management rules: pause seeding after a ratio limit, or remove completed torrents after a time period.
SABnzbd
- Configure the complete download directory within the shared volume.
- Create categories for Sonarr and Radarr with separate output directories.
- Enable direct unpack for immediate processing after download completion.
Monitoring the Pipeline
Application Dashboards
Each tool provides a web dashboard showing current activity:
- Sonarr: Calendar view of upcoming episodes, download queue, and import history.
- Radarr: Movie collection status, download queue, and upcoming releases.
- Prowlarr: Indexer health, search statistics, and sync status.
Notifications
Configure notifications in each tool for important events:
- New content added to library — send to Discord, Slack, email, or push notification.
- Download failures — alert so you can investigate.
- Health issues — disk space low, indexer unreachable, download client disconnected.
Tautulli for Plex
Tautulli monitors the Plex end of the pipeline — what is being watched, by whom, at what quality. Combined with Sonarr/Radarr data, you have full visibility from content discovery through playback.
Maintenance
Database Backups
Sonarr and Radarr maintain databases of your collection, quality history, and configuration. Back up these databases regularly. Both tools support automated backups in their settings — configure a backup schedule and retain at least a week of backups.
Updates
Keep all pipeline components updated. Docker makes this straightforward — pull new images and recreate containers. Each tool checks for updates automatically and displays notifications in the web UI.
Disk Space Management
Automated downloads fill storage quickly. Monitor disk usage and configure:
- Download client to pause when space drops below a threshold.
- Sonarr and Radarr to check space before initiating downloads.
- Automatic cleanup rules in the download client for completed and seeded items.
Troubleshooting
Content Not Downloading
- Check Prowlarr indexer health — a failed indexer means no search results.
- Verify the download client is reachable from Sonarr/Radarr.
- Check the Sonarr/Radarr Activity tab for search results and download decisions.
Files Downloaded But Not in Plex
- Import failed in Sonarr/Radarr. Check Activity, History for import errors — usually a permissions issue.
- Plex notification not configured. The file may be in the library directory but Plex has not scanned yet.
- File path mismatch between containers. Verify all containers use consistent volume mappings.