Skip to content

Deluge in Docker on a Synology NAS

Last updated on 24 July 2022

UpdateDate
New guide for Deluge13/09/2021
Fixed port settings section and added notes around plug-ins30/12/2021
Added an extra plugin and note on how to enable them06/03/2022
Updated with DSM7.1 Screenshots and Steps09/07/2022
Added new port settings and Docker Bridge Network23/07/2022


What is Deluge?

Deluge is a lightweight torrent downloader, it has a number of built-in plugins to help organise your downloads and a full web interface.

Let’s Begin

In this guide I will take you through the steps to get Deluge up and running in Docker if you want to also run a VPN see my alternative guide on the left-hand menu.

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

Downloading the Container

Open up Docker within DSM and navigate to the ‘Registry’ section and search for ‘deluge’ in the search box and download the ‘linuxserver/deluge’ image.

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 Deluge’ image and click on ‘Launch’

You will be greeted with the Network screen, we will be using the ‘synobridge’ network we created earlier select it from the list and click Next.

General Settings

Next you will be greeted with the General Settings screen, this is where you can start specifying some of your preferences.

You can change the name of the container to anything you like, and you may want to enable Auto Restart as this will ensure Deluge starts automatically if you reboot your NAS.

You will also notice a Configure capabilities button — don’t change anything in here!

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.

Environment

Next we are going to set up some environment variables that docker will use to allow the container access to our files.

Fill in the following details as per the table/screenshot, you will need to do them one at a time.

VariableValue
PUIDThe UID you obtained in the user setup guide
PGIDThe GID you obtained in the user setup guide
TZYour timezone wikipedia.org/wiki/List_of_tz_database_time_zones

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

Press ‘Save’ to go back to the initial setup screen, then press ‘Next’

Port Settings

We won’t be changing any of the ports the container uses. You can repeat the ones shown on the right side of the settings page ‘Container Port’ onto the left side ‘Local Port’ once you have done this press ‘Next’.

You can now click Next

Volume Settings

We will now be specifying the directories where Deluge will store its configuration files and where to download files to.

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

Now add ‘/config’ to the ‘Mount path’ box

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

You will now enter ‘/data/torrents’ into the ‘Mount path’ box

Your path settings should now look like the table/screenshot below.

File/FolderMount path
docker/deluge/config
data/torrents/data/torrents

Click Next to move to the final screen.

Click Next to move to the final screen.

Summary

You have now completed the setup of the container.

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.

Finally, click on Done and the container should start to boot.

Setting up Deluge

As we have used /data/torrents as the mount point for our downloads we need to make sure Deluge uses this same file path.

We are going to do this by just changing the directory settings within Deluge.

Open a new browser tab and go to your NAS IP address on port 8112 (e.g. 192.168.0.46:8112)

Deluge by default has the password of ‘deluge’ to access the web UI, you can change or remove this later in the settings.

Next you will connect to the Deluge back end, just select the host and click connect, it will remember this going forward.

Download Paths

Now you are in the UI click on Preferences at the top of the screen, we are going to change the various folders to the settings shown in the screenshot/table below

OptionFromTo
Download to:/root/Downloads/data/torrents/incoming
Move complete to:/root/Downloads/data/torrents/completed

Port Number

You will also need to set the port number in the Incoming Port section of the Network settings, this aligns with the ports we set earlier in the guide.

Press apply and hit OK, your last task will be to port forward your router to you NAS the TCP and UDP ports of 6881 to ensure you get connected.

Plugins

There are a couple of plugins you will want to enable in the Plugins’ section in Preferences, when enabled you will need to refresh the page to see them.

  • Autoadd – This allows you to pull in any torrents in the watch directory (screenshot below)
  • Label – This allows Radarr/Sonarr to assigned labels and pull downloads into subdirectories
  • Auto Remove Plus – Download the ‘AutoRemovePlus-2.0.0-py3.8.egg’ version from the Deluge forums and place it in the Plugins’ folder in /docker/deluge/plugins. It allows you to fine tune when to remove torrents and their associated data once downloaded. (You may need to stop and and start the container for this to appear)
Autoadd Plugin Settings


Docker Compose

You can use the below code saved as deluge.yml in the ‘/docker/deluge’ share, this will do the entire process above in one quick command via SSH. Ensure you change the variables to your own (Note you will still need to do the Final Steps section)

version: "3.8"
services:
  linuxserver-deluge:
    image: linuxserver/deluge:latest
    container_name: deluge
    environment:
      - PUID=YOURUID
      - PGID=YOURGID
      - TZ=Your/Timezone
    volumes:
      - /volume1/docker/deluge:/config
      - /volume1/data/torrents:/data/torrents
    network_mode: synobridge
    ports:
      - 8112:8112
      - 6881:6881/tcp
      - 6881:6881/udp
    restart: unless-stopped
sudo docker-compose -f /volume1/docker/deluge/deluge.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
Doge / Ethereum / Bitcoin
Published inDockerDownload ToolsSynology

55 Comments

  1. Ashleigh Ashleigh

    Could you please do other torrent downloaders. (like download client or other popular torrent downloaders)

    • Ashleigh Ashleigh

      I mean **download station

      • Dr_Frankenstein Dr_Frankenstein

        Hey, you can’t route download station through the docker network, using another client is possible though. Did you have any others in mind?

  2. So I get to the point of the guide for plugins and I dont see any plugins in the GUI and none are in the plugin folder, am i missing something?

    • Dr_Frankenstein Dr_Frankenstein

      Hey, in the preferences you should see a plugins section. You can enable the ones you want to use in there. I will add a note to the guide.

  3. Just a quick note for users who already have port 8112 in use by another container.
    Change the Local port 8112 to something else , like 8812, leave the container port ont 8112.
    Now, browse to your NAS – IP:8812 and continue the setup.

  4. You could probably add the Synology step of Control Panel: External Access -> Router Configuration -> Create Custom port TCP 6881, repeat for UDP 6881, then apply. This handles the router side for you using Synology

  5. You missed a config step for deluge, Open up Preferences -> Network and under Incomng Port, you have to untick Use Random Port or it will not listen on 6881

Leave a Reply

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

drfrankenstein.co.uk – writing Synology Docker Guides since 2016 – Join My Discord!