My Media Build

Radarr 7: What’s New and How to Upgrade Safely with Docker Compose

Radarr 7 is now stable (version 7.0.3).

spikey1965
Updated 17 November 2026
8 min read ▶ Video guide

At a glance

You'll end up with
Radarr 7 is now stable (version 7.0.3).
Tested with
Radarr 7.0.3
Updated
17 November 2026

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

Radarr 7 is now stable (version 7.0.3). It’s the biggest Radarr update in a while: you can now sign in through your own single sign-on (OIDC), skip the login for the computer Radarr runs on, use normal PEM certificates, pull movies from a Trakt Smart List and sort your library by popularity. This guide sets it up right next to a normal Radarr, to see what’s changed.

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 shows you Radarr 7 with Docker Compose the safe way: as a test copy that can’t touch your real movie library. If you like it, there’s a section at the end on moving your main Radarr over. New to Radarr? Start with the Radarr guide first. Already tried the Sonarr 5 beta guide? This works the same way.

✅ Update: Radarr 7 is now stable. The normal lscr.io/linuxserver/radarr:latest image is now Radarr 7, so a plain docker compose pull upgrades your Radarr. Back up your config folder first: when Radarr 7 starts, it upgrades its database, and Radarr 6 can’t open that database again. The test copy below is still a safe way to try it first. Use :latest in place of the pinned develop tag.

Watch: install Radarr with Docker Compose

The video has subtitles at the bottom and quiet background music. It was recorded on Radarr 7.0.3, the stable release this guide is about, and shows a normal install on port 7878. For the test copy, use port 7980 as in Step 2. The test film is Big Buck Bunny © Blender Foundation, peach.blender.org, licensed under Creative Commons Attribution 3.0.

Upgrade or test copy? Try it

Pick Upgrade my Radarr or Run a test copy, tick Back up first (or don’t), press Install Radarr 7, then press Go back to v6 and see what happens. Under the demo is the generator you’ll use in Step 2.

Interactive Try it right here

Open the generator full screen

What’s new in Radarr 7

  • OIDC login. Sign in to Radarr with the single sign-on you already use, such as Authentik, Authelia or Pocket ID, instead of a separate Radarr password. There’s a Remember Me option too.
  • Disabled for Localhost. A new choice for Authentication Required: no login only for the computer Radarr runs on, while everything else on your network still has to sign in. It’s tighter than Disabled for Local Addresses.
  • PEM certificates. If Radarr serves HTTPS itself, it now takes a normal .pem certificate plus a key file, the kind Let’s Encrypt gives you, not just a .pfx.
  • Trakt Smart Lists as an import list, and Popularity as a sort option for your movies and on the Discover page.
  • Under the hood: Radarr 7 runs on .NET 10. With Docker you don’t need to do anything about that; the new image includes it.
Radarr 7 Authentication Required box with OIDC chosen as the method and the new Disabled for Localhost option in the list
Both new login options in one box: OIDC as the method, and Disabled for Localhost.

What you need

Tip: the test copy runs on port 7980, with its own settings folder, its own movie folder and its own download category. Your normal Radarr on 7878 keeps running and never sees it.

1Make your folders

The test copy uses the same data folder as everything else, so hardlinks still work. It just gets its own movie folder inside it:

/data
├── torrents
│   └── movies-radarr7   ← the test copy's downloads
└── media
    ├── movies           ← your real movie library (Radarr 6)
    └── movies-v7-test   ← the test copy's movie library

The generator’s Commands tab creates these folders for you in Step 2.

2Make your compose file

In the generator, choose Radarr 7 and Test copy next to my Radarr, and fill in the same data folder your qBittorrent uses. Then on your server:

  1. Make a new folder, not the one your normal Radarr uses:
    mkdir -p ~/radarr7 && cd ~/radarr7
  2. Save compose.yaml and .env from the generator there.
  3. Run the commands from the Commands tab. They make the folders and start Radarr 7.

The generator uses lscr.io/linuxserver/radarr:latest, which is Radarr 7 now that it’s stable.

3Sign in

Open http://YOUR-SERVER-IP:7980. Radarr 7 has no login yet, so it opens straight to an Authentication Required box:

  1. Authentication Method: choose Forms (Login Page), then type a username and password. (Use OIDC instead if you already run a single sign-on server.)
  2. Authentication Required: leave it on Enabled.
  3. Click Save, and sign in with what you just typed.
Radarr 7 first start: the Authentication Required box with Authentication Method set to None and an empty Allowed Hosts field
What you see the first time. Radarr won’t let you in until you pick a method other than None.

Allowed Hosts is optional. Leave it empty and Radarr answers to any name or IP. If you fill it in (for example 192.168.1.10,localhost), Radarr ignores requests that use any other name.

4Connect qBittorrent and pick the movie folder

  1. Go to Settings → Media Management, click Add Root Folder and choose /data/media/movies-v7-test.
  2. Go to Settings → Download Clients, click + and choose qBittorrent.
  3. Host and Port: your server’s IP and 8080. Add your qBittorrent username and password.
  4. Category: movies-radarr7. This keeps the test copy’s downloads apart from your normal Radarr’s movies ones.
  5. Click Test (green tick), then Save.
Radarr 7 Add Download Client qBittorrent dialog with host 192.168.1.10, port 8080 and the category movies-radarr7
Radarr 7’s qBittorrent screen, with its own category. The API Key box is for qBittorrent’s newer API keys; you can leave it empty and use your username and password.

Using SABnzbd too? Add it the same way, with the category movies-radarr7, and make that category in SABnzbd under Config → Categories.

5Get your indexers from Prowlarr

  1. In Radarr 7, go to Settings → General and copy the API Key.
  2. In Prowlarr, go to Settings → Apps, click + and choose Radarr. Give it a name like Radarr 7 (test).
  3. Prowlarr Server: http://YOUR-SERVER-IP:9696. Radarr Server: http://YOUR-SERVER-IP:7980 (note: 7980). Paste the API key, then Test and Save.

Within a minute, your indexers appear in Radarr 7 under Settings → Indexers. Your normal Radarr keeps its own.

Try it: add one movie

  1. Click Movies → Add New and search for a film you have the right to download. Big Buck Bunny, a free Creative Commons film from the Blender Foundation, makes a good test.
  2. Pick the movies-v7-test root folder and a quality profile, then click Add Movie.
  3. Watch it appear under Activity → Queue. Then open Movies, click Sort and try the new Popularity option.

Only add a movie or two. If you import your whole library into the test copy, it will try to download everything a second time.

Radarr 7 Movies page in table view with the Sort menu open and Popularity at the bottom of the list
The new Popularity sort, on a test copy with three old public-domain films.

More new settings to look at

Trakt Smart Lists. Under Settings → Import Lists → +, the Trakt section now has a Trakt Smart List, for lists that Trakt keeps up to date for you.

Radarr 7 Add Import List window showing Trakt List, Trakt Popular List, Trakt Smart List and Trakt User
Trakt Smart List, next to the older Trakt lists.

HTTPS with a PEM certificate. Most people let a reverse proxy handle HTTPS, but if Radarr does it itself, go to Settings → General, click Show Advanced and tick Enable SSL. SSL Cert Path takes a .pem file now, and the new SSL Key Path takes its key.

Radarr 7 General settings with Enable SSL ticked, SSL Cert Path for a pfx or pem file and the new SSL Key Path field
The new SSL Key Path sits under SSL Cert Path.

Happy with it? Moving your main Radarr to v7

When you’re ready to move your real Radarr over, use the generator again and pick Upgrade my Radarr. Its Commands tab:

  1. Stops Radarr and copies its whole config folder. That copy is your only way back to v6, so don’t skip it.
  2. Starts Radarr 7 with your existing config. It upgrades the database on the first start, then everything is where you left it.

To go back to v6 later, stop Radarr, put the copied folder back and set the image back to a version 6 tag (the newest 6.x tag on the LinuxServer releases page). :latest is now Radarr 7, so it won’t take you back. Anything you changed while on v7 (new movies, history) is lost, because the copy is from before the upgrade.

Finished testing? Delete the test copy:

cd ~/radarr7 && docker compose down

Then delete its config and test folders, and remove Radarr 7 (test) from Prowlarr’s Apps.

If something’s wrong

  • “Bind for 0.0.0.0:7878 failed: port is already allocated”. The test copy is trying to use your normal Radarr’s port. Its compose file must say 7980:7878.
  • The Save button stays grey on the first screen. Pick an Authentication Method other than None and fill in a username and password.
  • The page says “Bad Request – Invalid Hostname”. You filled in Allowed Hosts and the name you typed isn’t in it. Add it in Settings → General, or open Radarr 7 by IP address.
  • Your normal Radarr imports the test copy’s downloads (or the other way round). They’re sharing a category. Give the test copy movies-radarr7 (Step 4).
  • Radarr 6 won’t start after trying v7. Radarr 6 can’t read a v7 database. Put back the config folder you copied before the upgrade.
  • Radarr offers an update under System → Updates. Don’t install it from there. With Docker, the Radarr team says to update by changing the image tag, as this guide does.

Updating Radarr 7

If you pinned the pre-release tag, change the image in compose.yaml to lscr.io/linuxserver/radarr:latest, which is now Radarr 7. After that, a plain pull keeps it up to date:

cd ~/radarr7
docker compose pull && docker compose up -d

Frequently asked questions

What's new in Radarr 7?

Single sign-on through your own provider (OIDC), skipping the login for the computer Radarr runs on, normal PEM certificates, Trakt Smart Lists, and sorting by popularity.

Can I go back from Radarr 7 to Radarr 6?

Only with a backup. Radarr 6 can't read a v7 database, so put back the config folder you copied before upgrading.

Can I run Radarr 7 next to Radarr 6?

Yes. Give the test copy its own port (7980), config folder, movie folder and download category (movies-radarr7), and the two never see each other.

Should I update Radarr from System → Updates?

No. With Docker, the Radarr team says to update by changing the image tag, as this guide does.

Thank you

Radarr is made by the Radarr team and is free and open source. You can support them on Open Collective, and read the full Radarr 7.0.0.10815 release notes. Thanks also to LinuxServer.io for the image.

Related guides: Radarr · Sonarr 5 beta · Prowlarr · qBittorrent

More app betas: Sonarr 5 · SABnzbd 5.2 · all betas

Comments

No comments yet. Questions and tips are welcome.

Leave a comment

Comments appear once I've read them. See the privacy policy.

Get new guides by email

About one email a month: new guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.