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

Radarr 7 pre-release: what's new, and how to try the pre-release safely

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 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.

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.
On this page (14 sections)

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.


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.

Step 1: Make 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.

Step 2: Make 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.

Step 3: Sign 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.

Step 4: Connect 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.

Step 5: Get 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 movie.
  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 my 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

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

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

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

Leave a Reply