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: Sonarr 5.0.0.2838 (beta)
Sonarr 5 is here as a beta. It’s the first big Sonarr release in almost two years: a fresh new look, a Statistics page, show details in more languages, and a few new security settings. This guide sets it up right next to a normal Sonarr, to see what’s changed.
This guide shows you Sonarr 5 with Docker Compose the safe way: as a test copy that can’t touch your real TV library. If you like it, there’s a section at the end on moving your main Sonarr over. New to Sonarr? Start with my Sonarr guide first.
On this page (13 sections)
- 1Upgrade or test copy? Try it
- 2What’s new in Sonarr 5
- 3What you need
- 4Step 1: Make your folders
- 5Step 2: Make your compose file
- 6Step 3: Sign in
- 7Step 4: Connect qBittorrent and pick the TV folder
- 8Step 5: Get your indexers from Prowlarr
- 9Try it: add one show
- 10Happy with it? Moving your main Sonarr to v5
- 11If something’s wrong
- 12Updating Sonarr 5
- 13Frequently asked questions
Upgrade or test copy? Try it
Pick Upgrade my Sonarr or Run a test copy, tick Back up first (or don’t), press Install Sonarr 5, then press Go back to v4 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 Sonarr 5
- A new look. Cleaner menus, rounder cards and a lighter theme. Everything is still in the same place, so you won’t get lost.
- A Statistics page. How many shows, seasons and episodes you have, how much is downloaded, and how much space it all takes.
- A Metadata Source page. Pick the language Sonarr uses for show and episode names when you add a show.
- New security settings. Allowed Hosts and Trusted Networks, explained in Step 3.
- A new first login. Sonarr 5 makes a user called
sonarrwith a random password the first time it starts (Step 3).

What you need
- 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 Sonarr 5 its indexers.
- About 15 minutes.
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 TV folder inside it:
/data
├── torrents
│ └── tv-sonarr5 ← the test copy's downloads
└── media
├── tv ← your real TV library (Sonarr 4)
└── tv-v5-test ← the test copy's TV library
The generator’s Commands tab creates these folders for you in Step 2.
Step 2: Make your compose file
In the generator, choose Sonarr 5 (beta) and Test copy next to my Sonarr, and fill in the same data folder your qBittorrent uses. Then on your server:
- Make a new folder, not the one your normal Sonarr uses:
mkdir -p ~/sonarr5 && cd ~/sonarr5 - Save compose.yaml and .env from the generator there.
- Run the commands from the Commands tab. They make the folders and start Sonarr 5.
The generator pins the beta to one exact version (develop-5.0.0.2800-ls203). Betas change often, so this way Sonarr 5 only updates when you decide to.
Step 3: Sign in
Sonarr 5 makes its own first login. Its username is sonarr, and the password is printed in the log:
docker compose logs sonarr5 | grep "created 'sonarr'"
- Open
http://YOUR-SERVER-IP:8990and sign in withsonarrand that password. - Go to Settings → General. Under Security, change the username and password to your own, then click Save Changes.
New in Sonarr 5: if you set Authentication Required to Disabled for Local Addresses, Sonarr makes you fill in Allowed Hosts first: the names and IP addresses you use to reach it, such as 192.168.1.10,localhost. Sonarr then ignores requests that use any other name. If you’re not sure, leave Authentication Required on Enabled.

Step 4: Connect qBittorrent and pick the TV folder
- Go to Settings → Media Management, click Add Root Folder and choose
/data/media/tv-v5-test. - Go to Settings → Download Clients, click + and choose qBittorrent.
- Host and Port: your server’s IP and
8080. Add your qBittorrent username and password. - Category:
tv-sonarr5. This keeps the test copy’s downloads apart from your normal Sonarr’stvones. - Click Test (green tick), then Save.

Step 5: Get your indexers from Prowlarr
- In Sonarr 5, go to Settings → General and copy the API Key.
- In Prowlarr, go to Settings → Apps, click + and choose Sonarr. Give it a name like Sonarr 5 (test).
- Prowlarr Server:
http://YOUR-SERVER-IP:9696. Sonarr Server:http://YOUR-SERVER-IP:8990(note: 8990). Paste the API key, then Test and Save.
Within a minute, your indexers appear in Sonarr 5 under Settings → Indexers. Your normal Sonarr keeps its own.
Try it: add one show
- Click Series → Add New and search for a show.
- Pick the
tv-v5-testroot folder and a quality profile, then click Add. - Watch it appear under Activity → Queue, then have a look round the Statistics page.
Only add a show or two. If you import your whole library into the test copy, it will try to download everything a second time.

Happy with it? Moving your main Sonarr to v5
When you’re ready to move your real Sonarr over, use the generator again and pick Upgrade my Sonarr. Its Commands tab:
- Stops Sonarr and copies its whole config folder. That copy is your only way back to v4, so don’t skip it.
- Starts Sonarr 5 with your existing config. It upgrades the database on the first start, then everything is where you left it.
To go back to v4 later, stop Sonarr, put the copied folder back and set the image to lscr.io/linuxserver/sonarr:latest again. Anything you changed while on v5 (new shows, history) is lost, because the copy is from before the upgrade.
Finished testing? Delete the test copy:
cd ~/sonarr5 && docker compose down
Then delete its config and test folders, and remove Sonarr 5 (test) from Prowlarr’s Apps.
If something’s wrong
- “Bind for 0.0.0.0:8989 failed: port is already allocated”. The test copy is trying to use your normal Sonarr’s port. Its compose file must say
8990:8989. - The page says “Bad Request – Invalid Hostname”. The name you typed isn’t in Allowed Hosts. Add it in Settings → General, or open Sonarr 5 by IP address.
- You can’t find the first password. Run the log command from Step 3. It’s only printed once, the first time Sonarr 5 starts.
- Your normal Sonarr imports the test copy’s downloads (or the other way round). They’re sharing a category. Give the test copy
tv-sonarr5(Step 4). - Sonarr 4 won’t start after trying v5. Sonarr 4 can’t read a v5 database. Put back the config folder you copied before the upgrade.
Updating Sonarr 5
The beta is pinned, so a plain pull won’t change it. When a new beta comes out (see the LinuxServer releases page for the newest develop-5.x tag), change the tag in compose.yaml, then:
cd ~/sonarr5
docker compose pull && docker compose up -d
Frequently asked questions
Is Sonarr 5 stable yet?
Not yet. As of November 2026 Sonarr 5 is a beta, which is why this guide runs it as a test copy next to your normal Sonarr. When it goes stable, this post will be updated.
Can I go back from Sonarr 5 to Sonarr 4?
Only with a backup. Sonarr 5 upgrades its database on first start and Sonarr 4 can't read it. Put back the config folder you copied before upgrading. Anything changed on v5 is lost.
What is the default Sonarr 5 login?
The username is sonarr. The password is random and printed in the container log once, the first time Sonarr 5 starts. Change both in Settings → General.
Can I run Sonarr 5 next to Sonarr 4?
Yes. Give the test copy its own port (8990), its own config folder, its own TV folder and its own download category, and the two never see each other.
What does "Bad Request – Invalid Hostname" mean in Sonarr 5?
The name you typed isn't in Allowed Hosts. Add it in Settings → General, or open Sonarr 5 by its IP address.
Thank you
Sonarr is made by the Sonarr team and is free and open source. You can support them on Open Collective, and read their Sonarr 5 beta announcement. Thanks also to LinuxServer.io for the image.
Related guides: Sonarr · Prowlarr · qBittorrent
More app betas: Radarr 7 · SABnzbd 5.2 · all betas
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.
