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 Wizard25/11/2021

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

When asked 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, if you want to you can change the name of the container to something else, or if you are using a number of services on a machine with a limited amount of memory or lower powered CPU you can also setup resource limitations, but this is generally not required.

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’

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

Now we have added these we need to specify where they will be mounted inside the container. As per the screenshot/table 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 setup anything on these tabs.

Environment Variables (PGID,  PUID and Timezone)

Next we are going to setup 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 you may need to re-boot your NAS – I am not sure why this happens for some but not others)

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 share, this will do the entire process above in one quick command via SSH. Ensuring 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.yml up -d --remove-orphans

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
  • Xrp
  • Polkadot
  • Binance coin
  • Litecoin
  • Bitcoin cash
  • Dogecoin
  • Tron
  • Monero
  • Omisego
Scan to Donate Bitcoin to bc1qfznx5kxad9k9z5t9y79mkm9ukfexan9a6wrzl0

Donate Bitcoin to this address

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

Scan to Donate Ethereum to 0x162fc7781D3C6c6f27197A3A92567b5DAF258f19

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 0x162fc7781D3C6c6f27197A3A92567b5DAF258f19

Donate Tether to this address

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

Scan to Donate Xrp to rKGpNHetksTn4dgwgpiTkg8JM4uJ3J6pam

Donate Xrp to this address

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

Scan to Donate Polkadot to 153iRH61nXQZUXMveZxCmYyzjf1cWYVnxpHpfifoNchQuXbY

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 qrc7scd2drzsd7kywpsjfklvkmm26fqc2vd7uyvdx9

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 Tron to TL1Q3vY9mHnDMedHRyU8ERUAY8SzJ4FXiV

Donate Tron to this address

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

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 !

  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.