For educational purposes only. This guide shows how to install self-hosted software on your own hardware. I don't condone piracy: only use these apps with media you own or have the right to use, and follow the law where you live. Back up your data first. Full disclaimer
Updated 16 November 2026 Tested with: Radarr 7.0.3
Radarr looks after your films. Add a film once and Radarr finds it on your indexers, picks the best version for your quality settings, sends it to your download client, then renames it and files it neatly in your library, ready for Plex. It also watches for films that aren’t out yet and grabs them on release.
Use these tools with media you own or have the rights to, and with legal sources such as Linux downloads and public-domain films. Downloading copyrighted material without permission is illegal in the UK and most other countries.
This guide sets up Radarr with Docker Compose in six short steps. It takes about 15 minutes. It works best alongside qBittorrent and Prowlarr, the earlier guides in this series.
On this page (14 sections)
- 1Watch: install Radarr with Docker Compose
- 2See what Radarr does
- 3What you need to set up Radarr with Docker Compose
- 4Step 1: Get your folders right
- 5Step 2: Make your compose file
- 6Step 3: Sign in
- 7Step 4: Tell Radarr where your films go
- 8Step 5: Connect qBittorrent
- 9Step 6: Get your indexers from Prowlarr
- 10Try it: add your first film
- 11Video formats explained
- 12If something’s wrong
- 13Updating Radarr
- 14Frequently asked questions
Watch: install Radarr with Docker Compose
The video has subtitles at the bottom and no sound. It was recorded on a clean test install. The test film is Big Buck Bunny © Blender Foundation, peach.blender.org, licensed under Creative Commons Attribution 3.0. Every video format Radarr uses is explained in Video formats explained below.
See what Radarr does
Press Add film and follow it through all five stages. Then untick Same disk (hardlinks) and add it again. That one setting is the most common mistake people make. Under the demo is the generator you’ll use in Step 2.
Open the generator full screen
What you need to set up Radarr with Docker Compose
- A computer or NAS running Docker. New to Docker? The Docker install guide covers Windows, Mac and Linux.
- A download client: qBittorrent, or SABnzbd for Usenet.
- Prowlarr, to give Radarr its indexers.
Step 1: Get your folders right
This is the step that matters most. Downloads and films must live inside one data folder on the same disk, like this:
/data
├── torrents
│ └── movies ← qBittorrent downloads here
└── media
└── movies ← your library (Plex reads this)
Radarr then gets one folder, the whole of /data. When a download finishes, Radarr can make a hardlink: the same file shows up in your library instantly, without being copied, and only uses its space once. qBittorrent keeps seeding the original, and Plex sees a tidy name.
/downloads and /movies, or putting them on different disks. Hardlinks can’t cross between them, so every film is copied. That’s slow, and every film takes up double the space.Use the same data folder in the qBittorrent generator and this one, and you’re set.
Step 2: Make your compose file
In the generator, choose On its own (recommended), tick My qBittorrent runs behind Gluetun if it does, and fill in your details. Then on your server:
- Make a folder and go into it:
mkdir -p ~/radarr && cd ~/radarr - Save compose.yaml and .env from the generator there.
- Run the commands from the Commands tab. They create the folders, give them to your user and start Radarr.
Want 4K? One Radarr handles it: pick the Ultra-HD quality profile. Video formats explained covers what each format means.
Step 3: Sign in
Open http://YOUR-SERVER-IP:7878. The first time, Radarr asks you to set up a login: choose Forms (Login Page), set Authentication Required to Enabled, pick a username and password, and click Save.
Step 4: Tell Radarr where your films go
- Go to Settings → Media Management.
- Scroll to Root Folders, click Add Root Folder and choose
/data/media/movies. - At the top, click Show Advanced. Under Importing, check that Use Hardlinks instead of Copy is ticked. It is by default.
- While you’re here, tick Rename Movies so every film gets a clean name. Then click Save Changes.


Optional: better file names
Radarr’s default names work, but these give Plex the best chance of matching every film, and show the quality and release at a glance. They’re based on the TRaSH Guides. In Settings → Media Management, under Movie Naming, paste each one into its box and click Save Changes.
Standard Movie Format:
{Movie CleanTitle} {(Release Year)} {tmdb-{TmdbId}} {edition-{Edition Tags}} {[Custom Formats]}{[Quality Full]}{[MediaInfo 3D]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[Mediainfo VideoCodec]}{-Release Group}
Movie Folder Format:
{Movie CleanTitle} ({Release Year}) {tmdb-{TmdbId}}
A film then ends up like this. The {tmdb-…} part tells Plex exactly which film it is, even when two share a name:
Big Buck Bunny (2008) {tmdb-10378}/
└── Big Buck Bunny (2008) {tmdb-10378} [Bluray-1080p][DTS 5.1][x264]-GROUP.mkv
Step 5: Connect qBittorrent
- Go to Settings → Download Clients, click + and choose qBittorrent.
- Host and Port: copy them from the generator’s Connect tab. Usually it’s your server’s IP and
8080. - Username and Password: your qBittorrent login.
- Category:
movies. That’s what makes downloads land in/data/torrents/movies. - Click Test (green tick), then Save.

Step 6: Get your indexers from Prowlarr
- In Radarr, go to Settings → General and copy the API Key.
- In Prowlarr, go to Settings → Apps, click +, choose Radarr, fill in the two server addresses from the Connect tab, and paste the API key.
- Click Test, then Save.

Within a minute, your indexers appear in Radarr under Settings → Indexers. Full details are in Step 6 of the Prowlarr guide.
Try it: add your first film
- Click Movies → Add New and search for a film you have the right to download. The free, open film Big Buck Bunny is a good test.
- Click it, pick your root folder and a quality profile (HD-1080p is a good start).
- Tick Start search for missing movie and click Add Movie.
Within a minute it shows up under Activity → Queue and in qBittorrent. When it finishes, it appears in /data/media/movies with a clean name. 🎉
Video formats explained
Every film file has a resolution, a source and a codec, and some also have HDR. Radarr reads these from the file name. Your quality profile uses the resolution and source to decide what Radarr may download and when to upgrade. Custom formats (Settings → Custom Formats) can score codecs, HDR and audio on top. Here’s what each one means.
Resolution
| Name | Pixels | What it is |
|---|---|---|
| SD (480p / 576p) | 720×480 or 720×576 | DVD-level picture. Fine on a phone, soft on a big TV. |
| 720p | 1280×720 | HD. Small files, good for tablets and slow connections. |
| 1080p | 1920×1080 | Full HD. The best balance of size and picture for most TVs. |
| 2160p (4K) | 3840×2160 | Ultra HD. Needs a 4K TV and a lot more disk space. Often comes with HDR. |
Source: the quality names in Radarr
These names describe how a file was made. Radarr uses them for every file, including copies of discs you own: a Blu-ray you back up with a tool like MakeMKV shows up as Remux or Bluray.
| Quality name | What it means | Typical 1080p film |
|---|---|---|
| SDTV / HDTV | Recorded from a TV broadcast, for example with an HDHomeRun tuner. | 3 to 8 GB |
| DVD | Made from a DVD. Always SD. | 1 to 4 GB (SD) |
| WEB-DL | The file as a streaming service delivers it, not re-encoded. | 4 to 10 GB |
| WEBRip | Re-encoded from a streaming service’s stream. Usually a little lower quality than WEB-DL. | 2 to 6 GB |
| Bluray-720p / 1080p / 2160p | Encoded from a Blu-ray disc into a smaller file. | 6 to 15 GB |
| Remux-1080p / 2160p | The Blu-ray’s video and audio copied as they are, without re-encoding. The best quality and the biggest files. | 20 to 40 GB (50 to 90 GB for 4K) |
| BR-DISK | A complete Blu-ray disc image with menus. Plex and Jellyfin can’t play it well, so leave it unticked. | 25 to 50 GB |
| Raw-HD | Uncompressed broadcast capture. Huge and rarely useful, so leave it unticked. | very large |
Leave CAM, TELESYNC, TELECINE and WORKPRINT unticked. Radarr lists them because they exist, but they’re recordings made in cinemas or from unfinished copies of a film. The picture and sound are poor, and they’re illegal to share. That’s also why the Any profile isn’t a good choice: it includes them.
Which quality profile to pick
| Profile | Downloads | Good for |
|---|---|---|
| HD-1080p | 1080p from TV, web and Blu-ray sources | Most people. Start here. |
| HD-720p/1080p | 720p or 1080p | Saving space, or older TVs. |
| Ultra-HD | 2160p (4K) only | A 4K TV and plenty of disk space. |
| SD | DVD-level only | Phones and small screens. |
To change what a profile accepts, open it under Settings → Profiles, tick or untick qualities, and drag them into order. Higher in the list means preferred. Tick Upgrades Allowed if you want Radarr to replace a film when a better version comes along.
Video codecs
The codec is how the picture is compressed. It decides the file size and which devices can play it without your server having to convert it on the fly (transcoding).
| Codec | What to know |
|---|---|
| H.264 (AVC, x264) | The most compatible. Plays on almost everything, but files are bigger. |
| H.265 (HEVC, x265) | About half the size of H.264 for the same picture. Most TVs and streaming sticks from 2016 on play it; older ones make the server transcode. |
| AV1 | The newest and smallest. Needs recent hardware: TVs and sticks from about 2021, and newer graphics chips. |
| VC-1 and MPEG-2 | Older codecs found on some Blu-rays and DVDs. Big files, and some devices can’t play them. |
| MPEG-4 Part 2 (Xvid / DivX) | Very old, SD only. Fine to replace with something newer. |
Running short of space? Tdarr can convert your library to H.265 automatically.
HDR formats
HDR (high dynamic range) gives brighter highlights and richer colour, mostly on 4K files. Your TV has to support the format, or the player converts it.
| Format | What to know |
|---|---|
| SDR | Standard dynamic range. Every non-HDR file. Plays everywhere. |
| HDR10 | The most common HDR format. Works on nearly every HDR TV. |
| HDR10+ | HDR10 with scene-by-scene adjustments. Mainly Samsung TVs; others fall back to HDR10. |
| Dolby Vision | Scene-by-scene HDR on Dolby Vision TVs and players. Files with an HDR10 fallback play on any HDR TV. Profile 5 files have no fallback and show green and purple colours on TVs without Dolby Vision. |
| HLG | Broadcast HDR, used by TV channels such as the BBC. Plays as SDR on older TVs. |
If your TV doesn’t support Dolby Vision, use a custom format to avoid Dolby Vision files without an HDR10 fallback. The TRaSH Guides have ready-made custom formats for all of these, and Profilarr can sync them for you.
Audio, in brief
| Format | What to know |
|---|---|
| AAC | Small and plays everywhere. Common on web files. |
| AC3 (Dolby Digital) / E-AC3 (Dolby Digital Plus) | 5.1 surround. E-AC3 can carry Dolby Atmos on streaming files. |
| DTS / DTS-HD MA | Common on Blu-rays. DTS-HD MA is lossless. |
| TrueHD (Atmos) | Lossless Blu-ray audio, often with Atmos. Needs a receiver or soundbar that supports it. |
If something’s wrong
- “No files found are eligible for import” or a path error. qBittorrent and Radarr are using different folders. Both must use the same data folder on your server, and qBittorrent must save into
/data/torrents. - Imports are slow and fill the disk. Hardlinks aren’t working. Downloads and films must be on the same disk, and Radarr must get the whole
/datafolder as one volume (Step 1). - Test fails for qBittorrent. Check the host and port on the Connect tab. If qBittorrent is behind Gluetun, its port has to be on Gluetun, and Radarr reaches it at your server’s IP.
- Nothing gets found. Check Settings → Indexers has indexers from Prowlarr. If it’s empty, redo Step 6.
- “Access to the path is denied”. The folders don’t belong to your PUID/PGID. Run the
chownline from the Commands tab again.
Updating Radarr
cd ~/radarr
docker compose pull && docker compose up -d
Want to try Radarr 7? It’s out as a pre-release. The Radarr 7 guide shows what’s new and runs it as a test copy next to this one, so your real Radarr isn’t touched.
Frequently asked questions
What does Radarr do?
Radarr looks after your films. Add a film once and it finds it on your indexers, picks the best version for your quality settings, sends it to your download client, then renames it and files it in your library for Plex or Jellyfin.
Why does Radarr say "No files found are eligible for import"?
qBittorrent and Radarr are using different folders. Both must use the same data folder on your server, and qBittorrent must save into /data/torrents.
Why do imports fill up my disk?
Hardlinks aren't working, so every film is copied. Downloads and films must be on the same disk, and Radarr must get the whole /data folder as one volume.
Can Radarr download 4K films?
Yes. Pick the Ultra-HD quality profile, or add the 2160p qualities to your own profile. You don't need a second Radarr: one handles 4K and HD.
What is the difference between HDR10 and Dolby Vision?
Both are HDR formats. HDR10 works on nearly every HDR TV. Dolby Vision adjusts the picture scene by scene but needs a Dolby Vision TV or player; files with an HDR10 fallback still play on other HDR TVs.
Which is better, H.264 or H.265?
H.265 (HEVC) gives the same picture at about half the size, but older TVs and sticks may not play it, so your server has to transcode. H.264 plays on almost everything.
Thank you
Radarr is made by the Servarr team and is free and open source. You can support them on Open Collective. Thanks also to LinuxServer.io for the image, and to the TRaSH Guides, whose folder layout this guide uses.
Next in this series: Sonarr, which does the same for TV shows.
If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.
Get new guides by email
About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.
