Skip to content

SABnzbd in Docker on a Synology NAS

Added Docker Compose details
Added new folder mappings to ensure atomic moves and Hard-linking
Guide re-written and updated with DSM7 screenshots 01/08/2021
Added note about rebooting if you are unable to access the Setup Wizard14/01/2022

In this guide I will take you through the steps to get SABnzbd up and running in Docker.

In order for you to successfully use this guide please complete the two preceding guides

Downloading the Container

In the majority of my guides I use the containers made by LinuxServer, these have very good documentation and are very well maintained so should any issues arise there is a group of people to ask.

Open up Docker within DSM and navigate to the ‘Registry’ section and search for sabnzbd in the search box. Right click and download the Linuxserver version.

The pop-up box will ask which version you want to download, make sure you choose ‘Latest’ from the list of available versions.

You can check the status of the download over on the ‘Image’ tab.

Setting up the container

In Docker click on the ‘Image’ tab, in the list of your containers select the ‘linuxserver/sabnzbd’ image and click on ‘Launch’

You will now see the initial setup screen, you can change the name of the container, we are not going to change the resource limitations.

Next up we are going to click on the ‘Advanced Settings’ button, this will take you to a new window with a number of tabs which we are going to work through.

On the first tab enable ‘Auto Restart’ this will ensure SABnzbd will automatically start up whenever you reboot your NAS.

Volumes / Mounts

We can now move onto the volume tab in which we will be specifying the directories where SABnzbd will store its configuration files and where to download to.

Click on Add Folder, click on the docker folder and create a new sub-folder called ‘sabnzbd’ select this folder and click ‘select’

This first folder will map to /config in the mount path section.

Click Add Folder again and this time select the ‘data/usenet’ folder and click Select.

In the Mount path section for this folder enter ‘/data/usenet’

Your mounts should now look like the table/screenshot below.

File/FolderMount path


We are not going to be specifying specific ports for SABnzbd to use as we want to keep things simple, tick the ‘Use the same network as Docker Host’

Links / Port Settings

You do not need to set up anything on these tabs.

Environment Variables (PGID,  PUID and Timezone)

Next we are going to set up a couple of environment variables that docker will use to allow the container access to our files and folders and also to tell it where we live in the world.

Click the Add button, and fill in the following details as per the table/screenshot, you will need to do one at a time.

PUIDThe UID you obtained in the user setup guide
PGIDThe GID you obtained in the user setup guide
TZYour timezone

Almost done

You have now completed the setup of the container.

Click on Apply to move back to the initial settings screen and then click next, you will be shown an overall summary of the settings we have specified, this is a good time to double-check everything is correct. Finally, click on Done and the container should start to boot.

Some final steps

SABnzbd will now be running on port 8080 you can connect to it by going to the IP address of your NAS with that port


Once you have completed the setup wizard, go into the settings and amend your folders to the following

(Please note, if you have trouble accessing the setup wizard or get an error after the first step. Stop the Docker package in the Package Centre and restart it, or in some cases do a reboot, this seems completely random and only doesn’t always happen)

Once you have gone past the initial set up screens you will need to ensure your folders are configured correctly as per the table/screenshot below.

Temporary Download Folder/data/usenet/intermediate
Completed Download Folder/data/usenet/completed
Watched Folder/data/usenet/nzb

Docker Compose

You can use the below code saved as sabnzbd.yml in the ‘/docker/sabnzbd’ share, this will do the entire process above in one quick command via SSH. Ensure you change the variables to your own

version: "3.2"
    image: linuxserver/sabnzbd:latest
    container_name: sabnzbd
      - TZ=Your/Timezone
      - /volume1/docker/sabnzbd:/config
      - /volume1/data/usenet:/data/usenet
    network_mode: host
    restart: unless-stopped
sudo docker-compose -f /volume1/docker/sabnzbd/sabnzbd.yml up -d

Throw me some bits or buy me a coffee?

If you have found my site useful please consider pinging me a tip as it helps cover the cost of running the site, you can even buy me a coffee 🙂

Buy Me A Coffee
  • Bitcoin
  • Ethereum
  • Tether
  • Cardano
  • Polkadot
  • Binance coin
  • Litecoin
  • Bitcoin cash
  • Dogecoin
  • Monero
  • Omisego
Scan to Donate Bitcoin to bc1qfq8ccs2yar7aa60fye8wdpanwtvpqzvrys4h6u

Donate Bitcoin to this address

Scan the QR code or copy the address below into your wallet to send some Bitcoin

Tag/Note:- Donations
Scan to Donate Ethereum to 0x7C5A441a6Dd520a796442DC6DeFeFE88d79D95f3

Donate Ethereum to this address

Scan the QR code or copy the address below into your wallet to send some Ethereum

Scan to Donate Tether to 0x7C5A441a6Dd520a796442DC6DeFeFE88d79D95f3

Donate Tether to this address

Scan the QR code or copy the address below into your wallet to send some Tether

Scan to Donate Cardano to addr1qysaldwdyqu9u8y9a0l5d35sqv202xr4768se8wevlexatepm76u6gpctcwgt6llgmrfqqc575v8ta50pjwajeljd6hsa6ggvv

Donate Cardano to this address

Scan the QR code or copy the address below into your wallet to send some Cardano

Scan to Donate Polkadot to 14R7Xr3587UKYsnnLhvBd7YfVgXkW9i3FU4kHP8DocsdLSha

Donate Polkadot to this address

Scan the QR code or copy the address below into your wallet to send some Polkadot

Scan to Donate Binance coin to bnb14ye5rju74u5ythneaum2rjvp8eqep6wq8flghx

Donate Binance coin to this address

Scan the QR code or copy the address below into your wallet to send some Binance coin

Scan to Donate Litecoin to LfNfer3aSqLx4p8KfbbkT96ArXLXLDPxoD

Donate Litecoin to this address

Scan the QR code or copy the address below into your wallet to send some Litecoin

Scan to Donate Bitcoin cash to qqz9pgaxdz4mtdxqxnlk7apqmsn6qzw9j5pn5jpvrc

Donate Bitcoin cash to this address

Scan the QR code or copy the address below into your wallet to send some Bitcoin cash

Scan to Donate Dogecoin to DCwbNzfYHx22MDSyEVLWgfjxziYHtcgwAM

Donate Dogecoin to this address

Scan the QR code or copy the address below into your wallet to send some Dogecoin

Scan to Donate Monero to 45qwFr42XiA8egC5z2HdSQ2FzzP9VR1MvD5Sicg4EhGvdvTutx9GsF6DeU8DHAsTZy2ShBERjCB5rdy8iQ9CFnFu9Z6Adgw

Donate Monero to this address

Scan the QR code or copy the address below into your wallet to send some Monero

Scan to Donate Omisego to 0x162fc7781D3C6c6f27197A3A92567b5DAF258f19

Donate Omisego to this address

Scan the QR code or copy the address below into your wallet to send some Omisego

Published inDockerSynology


  1. Lucas Lucas

    I’d like to use a different port for sabnzbd. How can I set that up in the network settings installation?

    • Dr_Frankenstein Dr_Frankenstein

      Hey, when setting up don’t tick the ‘Same as network host’ check box, then on the ports page you will need to change the port that says AUTO to your specified port number, the other port leave as it is.

      • Lucas Lucas

        Worked perfectly, thank you!

  2. Great tune thank you but you’ve missed out on an important bit in the setup in the Categories tab in SABnzbd and this bit has me confused as I know it’s needed.
    The other thing that confuses me is that for some unknown reason I cannot for the life of me see Volume 1 to get to my Media. It just won’t show for some reason.

    • Dr_Frankenstein Dr_Frankenstein

      You can add categories if you like, I just cover the initial setup… You won’t see the volumes in the syno GUI they are hidden you just map the shares you require.

      • Dr_Frankenstein Dr_Frankenstein

        Also to add if you add categories don’t add any paths, let Sonarr and Radarr handle the file moves

  3. Nicholas J Gonzalez Nicholas J Gonzalez

    Can you make one of your guides for installing plex on DM7? I loved the SAB,Sonarr and Radarr guides THANK YOU Very Much!

    • Dr_Frankenstein Dr_Frankenstein

      Yes, it’s in the works.

  4. I just receive a ‘500 Internal Server Error’ when attempting to move to /sabnzbd/wizard/two page on the sabnzbd setup wizard. It seems to be complaining about Pyhton 3.8.

    Traceback (most recent call last):
    File “/usr/local/lib/python3.8/dist-packages/cherrypy/”, line 638, in respond

    • Dr_Frankenstein Dr_Frankenstein

      Maybe try downloading the image again.

      • Dr_Frankenstein Dr_Frankenstein

        Thanks for jumping through some hoops in Discord – The solution seems to be to delete all the files SAB creates at first start up in the /docker/sabnzbd folder and start again… It seems like a bug at startup.

        • Aaron Aaron

          doesn’t seem to resolve my issue. I’ve stopped, deleted the contents of the folder numerous times with no luck. Ive also redownloaded the image and resetup the container with no luck, always get the same “Traceback (most recent call last):
          File “/usr/local/lib/python3.8/dist-packages/cherrypy/”, line 638, in respond

          • Dr_Frankenstein Dr_Frankenstein

            Very weird, it’s hard to call what could be causing it. As it’s effects some people buy not others. It would be a good idea to post this as an issue on the Linuxserver discord

          • chzplz chzplz

            I’m having the same issue. Tried the same things, no luck.

          • Dr_Frankenstein Dr_Frankenstein

            It’s worth reporting this as an issue on Github as it seems to be affecting a number of Synology users

    • Dr_Frankenstein Dr_Frankenstein

      Did you sort this, according to the linuxserver github they fixed this issue last year? did a restart of the container help?

      • Hi – I never actually got the wizard/two page to load but by restarting my php installation and restarting the containers I was just able to login to the SAB interface without issue, just using the IP:port address. I cannot say why the error happened, I’ve not looked into root cause.

      • I encountered the same error, and when I checked on the installed packages in my Package Center it had Python2 installed, not Python 3.8. So I just selected Python 3.8 to install, rebooted the NAS, and SABnzdb worked.

        • Dr_Frankenstein Dr_Frankenstein

          The container has all the required packages within it, it must have just been the reboot that fixed it.

          • Hello, I have had the same problem… I solved it by restarting the NAS…
            Thanks a lot for this awesome guide !

    • I had the same error at the launch but afterwhile it just disappeared

    • xpen xpen

      close/restart docker syno package – no need to restart NAS

      • Dr_Frankenstein Dr_Frankenstein

        A couple of people this didn’t work for, I will add to the notes though.

  5. Alan J Woodward Alan J Woodward

    Many thanks for this – this worked perfectly for me on Synology 1821+

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.