Our search function may intermittently fail to display results. If this happens, try refreshing the page, as this usually resolves the issue. We’re working on a permanent fix. Thank you for your patience!
Deluge
Deluge is a full-featured BitTorrent application written in Python 2. It has a variety of features, including but not limited to:
- Client/server model
- DHT support
- Magnet link support
- Plugin system
- UPnP support
- Full-stream encryption
- Proxy support
When the server daemon is running, users can connect to it via a console client, a GTK-based GUI, or a Web-based UI. A complete list of features can be viewed here.
Deluge is already configured and tuned out of the box. Once logged in for the first time, there will be a text box asking you if you want to change the default password, which you set in UCP. Click No.
Then, the Connection Manager settings will appear. Just click the host in the box and click Connect. After that, you are now logged into Deluge's Web UI.
Default File Paths
- Default Downloads Folder:
~/downloads/deluge - Deluge's config folder:
~/.config/deluge - Deluge's watch folder:
~/watch/deluge
Find IP Address
If your private tracker requests the IP of your torrent client, you can find it with the following instructions. Deluge will use a pooled IP for improved performance. You can see which IP is being used by Deluge from the Apps tab of your User Control Panel. Find Deluge in the list and press the Show Info button to reveal the Assigned IP: xxx.xxx.xxx.xxx.
Upgrade Deluge V1 to V2
To successfully upgrade your Deluge instance from v1 to v2, we recommend that you follow the below instructions to preserve your Deluge data directory and torrent session state.
Due to the nature of how our infrastructure installs and uninstalls Deluge preserving its data directory for an already installed instance, Deluge version 2 plugins being incompatible with Deluge version 1 plugins. It is recommended to follow these steps to manually upgrade your Deluge to version 2 while also preserving your current Deluge's torrents state.
- To prevent any torrents state from going into Error state due to a rare bug occurrence with Deluge. Make sure to pause all torrents within your Deluge instance and wait at least 2-3 minutes before proceeding to next step.
- Next, stop Deluge from the Apps tab on the UCP.
- Connect to your Ultra service via SSH, and execute the following command:
mv ~/.config/deluge ~/.config/deluge.BAK- Next, go back to the Apps tab on the UCP, and uninstall Deluge.
- Once the uninstall has finished, go to the Installers tab and install Deluge V2.
- Once the install has finished, go to the Apps tab and stop Deluge.
- After Deluge has been successfully stopped, return to your SSH terminal to restore your original Deluge v1 torrent session state. This is done by executing the following command:
cp -rv ~/.config/deluge.BAK/state/* ~/.config/deluge/state- After the above command has been successfully executed, go back to the Apps tab on the UCP and restart Deluge.
- Then, access your Deluge WebUI to confirm your Deluge instance has been upgraded to V2 and your torrent session state has been successfully restored.
In case you do opt to upgrade Deluge V1 to V2, please note the following:
- Deluge's V2 torrent session state CAN NOT be downgraded back to Deluge V1.
- Your Deluge preferences will be reset back to default, and you will need to manually configure any custom settings from your original Deluge V1 instance.
- Deluge V1 plugins are not compatible with Deluge V2, and you will need to re-install Deluge V2 compatible third party plugins that you wish to use.
- Currently, there are no official Mac OSX thin-clients compatible with Deluge V2.
Reset Password for Deluge WebUI
This section will show you how to reset your Deluge's Web UI password.
- Open your User Control Panel and click on the Access Details tab. You will find your SSH Access details on this page.
- If you are unsure of your username and password, see the Eye Icon.
- Connect to your Ultra service via SSH.
- Once connected, execute the following command:
app-deluge stop - Now on the empty line, type the following command and press ENTER.
sed -i.bak "/pwd_sha1/d" ~/.config/deluge/web.conf- Now on the next empty line, type the following command and press ENTER.
sed -i.bak "/pwd_salt/d" ~/.config/deluge/web.conf- Next, restart your Deluge instance by executing
app-deluge restart - Once started, enter
delugeas your password.
Set Up Deluge Thin Client
This section shows you how to install, configure, and connect your Deluge client to your slot's instance.
Deluge's Thin Client is a great way to manage your Deluge instance from your PC. It also gives you more customization to your Deluge instance, and some plug-ins, such as LabelPlus, do require that you need to have the thin client installed for you to access its settings.
Installation
- Download and install Deluge from the links below
Deluge Client version 1.x
Windows: https://ftp.osuosl.org/pub/deluge/archive/1.3/deluge-1.3.15-win32-py2.7.exe
MacOS: http://download.deluge-torrent.org/mac_osx/deluge-1.3.15.1-macosx-x64.dmg
Linux: Refer to your distributionDeluge Client version 2.x
Windows: https://ftp.osuosl.org/pub/deluge/windows/deluge-2.1.1-win64-setup.exe
MacOS: official version 2 client unavailable at this time
Linux: Refer to your distributionSet up Deluge Client
- Open up Deluge Client on your PC
- Click Preferences -> Interface and uncheck Classic Mode.
- Confirm to restart Deluge
- Once Rebooted, a window named Connection Manager appears. Click Add.
- Go back to your UCP, under Apps tab, find Remote Client Access under Deluge, and input the values accordingly.
- Once that's done, click add and wait for the Green circle to pop up.
- Once that's popped up, highlight your new details and click Connect.
Deluge Plugins
This section will show you how to install Deluge plug-ins. Deluge plug-ins extend the functionality of what Deluge provides, giving you more ways to automate processes or simplifying tasks. Take note that you need to check what plug-in you download. Specifically:
- If the plug-in is written for Deluge v.1.3.15
- It's written using python 2.7
- Its extension is
.egg - Also, take note if your plug-in can be accessed with the thin client or the web client.
Install Plugins
- Login to your Deluge's Client
- Download the plug-in that you want.
- Go to Preferences -> Plugin.
- Click Install Plugin and navigate to your
plugin_name.eggand click Open - This'll install the plug-in on your PC client and to the slot Client.
- After it's installed, tick the label name and click OK. You may have to do that a few times to get it properly installed.
Enable Public Torrent Seeding (Optional)
- Public torrents are stopped after download by default to avoid HDD IO resource abuse and inadvertent usage of upload traffic. You can easily enable public torrent seeding with the instructions given below.
- Connect to your Ultra service via SSH.
- Execute the following command:
app-deluge restart --remove-pubscript- That's it, public torrents can now be seeded.
- To enable the script again to stop public torrents from being seeded, execute the following command:
app-deluge restart --add-pubscript- Note that changing the password, repairing or reinstalling the torrent client will disable public torrent seeding again.
Torrent Queue
If you have an Ultra service with HDD instead of NVME, you need to be mindful of your disk neighbors and not hammer the disk with high IO utilization. See this guide for more information on how to check your disk IO utilization.
One way to mitigate this is to limit the amount of active downloads in your torrent client. Below you will find instructions on how to do this for Deluge.
- In the Deluge webUI, click on
Preferencesin the top menu bar. - Click on
Queuein the left-hand menu
- Set Downloading to
1-3depending on how it affects the disk IO utilization. - Set Total and Seeding to
500
As Deluge v1 only can handle up to 500 torrents before it becomes unstable, you would want to set the Total and Seeding to 500. Deluge v2 can handle somewhere between 1000-2000 torrents before it becomes unstable.
Troubleshooting Information
Why does Deluge keep crashing?
This is a typical characteristic of Deluge. It usually happens when downloading, where the client will prioritize torrent traffic over the WebUI. Deluge is aggressive and caches the information into the RAM. In turn, the Deluge WebUI loses connection, and the Daemon would appear offline.
It will come back/stabilize some minutes after the download is completed, and no action needs to be taken at that time.
If it's not coming back, a misconfigured plug-in may be interfering with Deluge. The usual case with this is ltconfig with high-performance seed pre-set engaged. This pre-set most likely crashes Deluge. We recommend using our default tunings first, as it is tuned specifically for our slots.
Why does the main IP of my slot and torrent clients appear different? Which IP should I report to trackers?
Our slot IPs are pooled to avoid clashing on trackers with a more extensive user database to help peers and seeders.
If you need to submit IP's, then you should use the IP's that are binding to the torrent clients.. You can obtain them by logging into Deluge and go to Settings -> Network -> Interface. Copy the IP from that field.
If you require further assistance, you can open a support ticket here!
Feedback and suggestions regarding this article are welcome on our Discord server