Getting how to use radarr right the first time saves a lot of troubleshooting later, so let us start with the basics. Radarr is a free, open-source archival data organizer that monitors indexers and RSS feeds, grabs matching posts automatically, and hands them off to a download client so your high-resolution media library builds itself.
Managing a large digital archive by hand gets exhausting fast. Files land in the wrong folders, naming conventions drift, and you miss releases the moment they go live. Radarr solves all of that by acting as the intelligent middle layer between your indexers, your download client, and your media server.
Setting up Radarr correctly from the start saves hours of manual sorting later. This guide walks through every step, from installation to quality profiles to Plex integration, in plain language built for data hoarders who want a reliable, automated pipeline.
Whether you are pulling content from Usenet or a seedbox, this guide covers the exact configuration steps that make the whole stack work together.
What Radarr Does In A Media Automation Stack
Radarr sits at the center of a broader automation pipeline, bridging the gap between indexers that list available releases and download clients that actually fetch them. It monitors RSS feeds, scores releases against your quality profiles, and triggers downloads automatically without manual input.
Where Radarr Fits Between Indexers And Download Clients
Radarr does not download anything itself. Its job is to watch for matching releases, evaluate them against your quality settings, and send a grab command to your Usenet download client. As noted in the Servarr Wiki, the software needs to communicate with your download client and have read and write access to the folder where downloaded files land.
The basic flow looks like this:
- Indexer lists a new release
- Radarr matches it against your monitored library and quality profile
- Radarr sends the grab to SABnzbd, NZBGet, or another Usenet download client
- The download client fetches the file
- Radarr imports, renames, and moves it to your root folder
Radarr Vs Sonarr Vs Readarr Vs Prowlarr
The arr stack is a family of tools that each handle a specific content type:
| Tool | Purpose |
|---|---|
| Radarr | Archival film and standalone releases |
| Sonarr | Episodic and serialized content |
| Readarr | Books and digital publications |
| Prowlarr | Centralized indexer management for all *arr apps |
Prowlarr is worth adding early. It syncs indexer configurations to Radarr, Sonarr, and Readarr in one place so you avoid configuring the same tracker repeatedly across every app.
How To Use Radarr For Initial Setup
Installation is straightforward across all major platforms, and the web UI guides you through the most critical first-run decisions. The key steps after installation are opening the UI, reviewing general settings, and defining your root folders before doing anything else.
Installing On Windows, Linux, macOS, Docker, And Raspberry Pi
Radarr provides native installers and packages for every common platform. The GitHub repository links to the latest release builds for each environment.
Windows: Download the installer from radarr.video and run it. Radarr installs as a Windows service and starts automatically on boot.
Linux: Add the Servarr repository and install via your package manager. The service runs under a dedicated user account, and you should confirm that account has read and write access to your media directories.
macOS: Install via Homebrew or the direct macOS package. Radarr runs as a background launchd service.
Docker: Docker is the most portable approach and the one most home lab operators prefer. A basic docker run command or Docker Compose file gets Radarr running in minutes. Map your config volume, your download folder, and your media folder as separate bind mounts.
Raspberry Pi: Use the Linux ARM package or a Docker image built for ARM. Performance is adequate for most library sizes, though large interactive searches can feel sluggish on older Pi hardware.
Opening The Web UI And Reviewing First-Run Settings
After installation, open a browser and navigate to http://[your-server-ip]:7878. Radarr runs on port 7878 by default.
On first launch, set up an authentication method. Forms-based login is the most common choice for home lab setups. Disable local address authentication bypass only if your network is properly segmented.
Under Settings > General, review the base URL if you plan to run Radarr behind a reverse proxy. Set your log level to Info initially, then bump it to Debug only when troubleshooting.
Preparing Root Folders And Library Paths
Root folders are the foundation of the whole setup. This is where Radarr imports finished downloads and where your media server reads the library.
Go to Settings > Media Management and scroll to the Root Folders section. Add the full path to your media directory, for example /home/user/media/films.
A few rules that prevent headaches later:
- Your download folder and root folder must be different directories
- The user running Radarr needs read and write access to both locations
- If you use NFS or SMB mounts, the Servarr Wiki recommends enabling
nolockfor NFS andnobrlfor SMB
Save changes before moving to the next section.
Adding Indexers And Connecting Download Clients
Indexers tell Radarr where to look for releases, and download clients handle the actual fetching. Getting both configured correctly is the most common place where new setups stall.
Adding An Indexer Directly Or Through Prowlarr
Go to Settings > Indexers and click the + button to add a Usenet indexer directly.
If you are running Prowlarr, the cleaner approach is to configure all your indexers there and let Prowlarr sync them to Radarr automatically. This keeps everything in one place and saves you from re-entering API keys every time you add a new indexer.
For Usenet, popular indexers include NZBgeek and NZBFinder. Enter the indexer URL, your API key from the indexer site, and test the connection before saving.
Connecting SABnzbd Or NZBGet For Usenet Workflows
Go to Settings > Download Clients and add a new client. For Usenet workflows, SABnzbd and NZBGet are the two most common options.
For SABnzbd:
- Host:
localhostor your server IP - Port:
8080by default - API Key: copied from SABnzbd’s Settings > General tab
- Category: set a dedicated category like
radarrso completed downloads land in a predictable folder
NZBGet configuration follows the same pattern. Use a dedicated category there too. As covered in real Sonarr and Radarr NZBGet configurations, setting a consistent category is what allows Radarr to find and import the finished file reliably.
Get Easynews for a Usenet provider that pairs cleanly with both SABnzbd and NZBGet.
Choosing Quality Profiles And Managing High-Resolution Libraries
Quality profiles are how Radarr decides which releases to grab and when to upgrade them. Setting a sensible cutoff prevents Radarr from endlessly chasing marginally better encodes once you already have a good copy.
Setting Quality Profiles For HD-1080p And High-Resolution Formats
Go to Settings > Profiles and either edit an existing profile or create a new one. Each profile lets you define which quality sources are acceptable, set a preferred language, and assign custom format scores.
The community resource TRaSH Guides is the most thorough reference for building profiles that balance file size against quality. Their custom format configurations are widely used by home lab operators to avoid problematic releases like BD-DISK rips labeled as standard encodes.
A practical starting profile for a high-resolution archive:
- Enable: Bluray-720p, Bluray-1080p, WEB-1080p
- Set your cutoff at Bluray-1080p so Radarr stops upgrading once it hits that tier
- Add custom formats for Dolby Vision and HDR flags if your playback hardware supports them
Organizing Media Management Rules And Naming Behavior
Under Settings > Media Management, enable Rename Files to apply a consistent naming convention across your library. The Servarr team recommends TRaSH’s naming schemes as a tested starting point.
Enable Use Hard Links Instead of Copy if your download folder and root folder are on the same filesystem. Hard links prevent Radarr from duplicating large files during import, which matters when storage is tight.
Turn on Import Extra Files if you want subtitles and NFO files pulled in alongside the main video file.
Handling Upgrades, Cutoffs, And Failed Download Handling
Radarr’s cutoff setting is the quality tier where automatic upgrading stops. Set it thoughtfully. If you set the cutoff too high, Radarr will keep grabbing incremental upgrades indefinitely.
Failed download handling is enabled by default and is one of the most useful features in the app. As noted on radarr.video, when a release fails because of a password, missing repair blocks, or another issue, Radarr blacklists it and attempts the next best match automatically. No manual intervention needed.
Check Activity > Queue occasionally to catch anything stuck in an import-failed state that needs a manual nudge.
Adding Items, Monitoring Releases, And Automating Imports
Once your indexers, download clients, and quality profiles are in place, adding content to Radarr’s library and letting it run on autopilot is straightforward.
Adding New Entries And Choosing Monitoring Options
Click + Add New from the main library view. Search by movie title for precise matching. Before saving, set the monitoring option:
- Movie Only: Radarr watches for new releases of that specific title
- Movie & Collection: Radarr also monitors and can automatically grab the rest of a franchise collection
- None: Adds the entry to your library without any active monitoring
Set the Minimum Availability to Released if your indexers frequently carry fake or mislabeled pre-release files. The Announced setting works well with trusted private indexers that vet their content.
Using RSS Feeds, Search, And Notifications
Radarr polls your indexers’ RSS feeds on a regular interval and grabs matching releases as they appear. This is the passive automation that makes the whole system hands-off.
For immediate results, use Interactive Search to see every available release for a given title ranked by your quality profile scoring. This is useful for backfilling older entries in your archive.
Notifications can be configured under Settings > Connect. Webhook and email integrations let you receive alerts when a grab succeeds, when an import fails, or when an upgrade is found.
Importing Existing Libraries And Fixing Path Issues
If you have an existing collection, use Movies > Import Existing and point Radarr at your root folder. Radarr attempts to match folder names against its movie database automatically.
Mismatches are common with older or unusual naming. Expand the error on any unmatched entry and verify the title and year, then correct the match manually if needed.
If a folder is named incorrectly, fix the name on disk, then refresh the entry in Radarr. As described in the Radarr quick start documentation, the year must appear in the folder name for Radarr to parse it correctly.
Integrations, Maintenance, And Everyday Best Practices
With the core pipeline running, connecting Radarr to a media server and adding companion tools completes the automation stack. Routine maintenance keeps everything healthy over time.
Syncing With Plex, Jellyfin, And Seerr
Radarr can trigger a library scan on Plex or Jellyfin immediately after a successful import. This means new content appears in your media server within seconds of landing on disk.
For Plex, go to Settings > Connect, add a Plex Media Server connection, and enter your Plex token. For Jellyfin, use the Emby/Jellyfin connection type with your API key. Both update the relevant library section automatically on import.
Jellyseerr connects to both Radarr and Jellyfin to provide a user-facing request interface. Family members or home lab guests can request content without ever touching Radarr’s UI directly.
Using Subtitle Automation Alongside Companion Apps
Radarr can import subtitle files that arrive alongside a release, but it does not search for subtitles independently. Bazarr fills that gap. It integrates with Radarr via API and monitors your library for missing subtitles, fetching them automatically from your configured subtitle provider.
The typical setup imports files through Radarr first and lets Bazarr handle subtitle population in the background on a schedule.
Privacy, Storage Planning, And Common Troubleshooting Steps
For privacy-conscious archival workflows, routing your download client through a VPN or using a Usenet provider with SSL and a no-logs policy adds a meaningful layer of protection. At datahoarder.io, we cover VPN and SSL best practices in depth for Usenet users looking to keep their activity private.
A few practical storage and maintenance habits:
- Set a Recycle Bin path in Settings > Media Management so deleted files are recoverable for a few days
- Monitor disk space at the root folder level; Radarr does not stop downloading when space runs low unless you configure disk space checks
- Check System > Logs weekly for repeated errors
- Back up your Radarr config folder (usually
/configin Docker) on a regular schedule; it contains your entire database, profiles, and settings
Get Newshosting to pair Radarr with a high-retention Usenet provider that keeps your pipeline running without interruption.