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: SABnzbd 5.1.3
SABnzbd downloads from Usenet, one of the oldest parts of the internet: a network of servers that also carries files. Connections are encrypted, and with a good provider downloads run at your full internet speed. Radarr and Sonarr send it what to fetch, and it downloads, repairs and unpacks everything for you.
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 SABnzbd with Docker Compose in five short steps. It takes about 15 minutes.
On this page (11 sections)
- 1Watch: install SABnzbd with Docker Compose
- 2See how a Usenet download works
- 3What you need to set up SABnzbd with Docker Compose
- 4Step 1: Make your compose file
- 5Step 2: Run the setup wizard
- 6Step 3: Set the folders
- 7Step 4: Add categories
- 8Step 5: Connect Radarr and Sonarr
- 9If something’s wrong
- 10Updating SABnzbd
- 11Frequently asked questions
Watch: install SABnzbd with Docker Compose
The video has subtitles at the bottom and no sound. It was recorded on a clean test install with example server details, so it skips the part where the wizard tests your provider. It uses one simple /downloads folder; the generator and steps below use the /data layout that Radarr and Sonarr need.
See how a Usenet download works
Press Download and watch the pieces arrive, get repaired and unpacked. Try a different number of connections. Under the demo is the generator you’ll use in Step 1.
Open the generator full screen
Want something lighter? NZBGet does the same job with less memory. Pick one of the two.
What you need to set up SABnzbd with Docker Compose
- A computer or NAS running Docker. New to Docker? The Docker install guide covers Windows, Mac and Linux.
- A Usenet provider account (the servers you download from). You get a server address, username and password.
- At least one Usenet indexer (the search sites), added in Prowlarr.
Step 1: Make your compose file
In the generator, choose On its own (recommended) and use the same data folder as Radarr and Sonarr. If qBittorrent already uses port 8080, set the web page port to 8085. Then:
mkdir -p ~/sabnzbd && cd ~/sabnzbd
Save compose.yaml and .env there, and run the commands from the Commands tab.
Step 2: Run the setup wizard
Open http://YOUR-SERVER-IP:8080 (or the port you chose). The wizard asks for your Usenet provider’s details:
- Host: your provider’s server address, for example
news.yourprovider.com. - Username and Password from your provider.
- Tick SSL and use port 563.
- Connections: the number your plan allows (often 20 to 50).
- Click Test Server, then Next.
Step 3: Set the folders
Go to Config (cog icon) → Folders and set:
- Temporary Download Folder:
/data/usenet/incomplete - Completed Download Folder:
/data/usenet/complete
Click Save Changes.

Step 4: Add categories
Go to Config → Categories and add two categories, movies and tv, each with a folder of the same name. Downloads from Radarr and Sonarr then land in their own folders.

Step 5: Connect Radarr and Sonarr
- In SABnzbd, copy the API Key from Config → General → Security.
- In Radarr, go to Settings → Download Clients → + → SABnzbd. Enter your server’s IP, the port, the API key and category
movies. Click Test, then Save. - Do the same in Sonarr with category
tv.
That’s it. Radarr and Sonarr can now send downloads to SABnzbd. 🎉
If something’s wrong
- “Access denied – Hostname verification failed”. You opened SABnzbd by a name rather than an IP. Add that name under Config → Special → host_whitelist.
- Test Server fails. Check the host, username and password, and use SSL on port 563.
- Downloads fail with missing articles. The post is too old for your provider. Radarr and Sonarr will try another release automatically.
- Radarr says the download folder doesn’t exist. SABnzbd and Radarr must share the same data folder, so both see
/data/usenet/complete.
Updating SABnzbd
cd ~/sabnzbd
docker compose pull && docker compose up -d
Thinking about SABnzbd 5.2? The 5.2 beta adds Indexer Search and changes how SABnzbd treats a reverse proxy. Read the SABnzbd 5.2 beta guide before you upgrade.
🧰 What I use

Proton VPN: works with Gluetun over WireGuard. Usenet downloads are already encrypted when you use SSL (port 563), so a VPN is optional for SABnzbd.
This is an affiliate link: if you sign up through it, I may earn a commission, at no extra cost to you. Use a VPN for privacy, and only download what you have the right to.
Frequently asked questions
What is SABnzbd?
SABnzbd downloads from Usenet, a network of servers that also carries files, over encrypted connections. Radarr and Sonarr send it what to fetch, and it downloads, repairs and unpacks everything for you.
What do I need to use Usenet?
A Usenet provider (a paid subscription that gives you the server, username and password) and at least one Usenet indexer, which you add to Prowlarr.
What does "Access denied - Hostname verification failed" mean?
You opened SABnzbd by a name rather than an IP address. Add that name under Config → Special → host_whitelist.
SABnzbd or NZBGet?
They do the same job, so pick one. SABnzbd is the more common choice and very easy to set up. NZBGet is lighter on memory and CPU. See my NZBGet guide.
Thank you
SABnzbd is free and open source, made by its volunteer team at sabnzbd.org. Thanks also to LinuxServer.io for the image.
If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.
☕Buy me a coffeeGet new guides by email
About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.
