Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > Deluge

Deluge is a full-featured open source BitTorrent client. It uses libtorrent in its backend and features multiple user interfaces. It has been designed using the client server model. The Deluge daemon is able to run on the server and handle all bittorrent activity while user interfaces are able to connect remotely from any platform.



The Web user interface offers easy access to Deluge from a web browser.

No configuration is necessary to use the Deluge WebUI. Just enable the Deluge WebUI on your Slot Settings page. It can then be accessed via the link on your Manage page.

GTK+ "Thin Client"

The GTK+ user interface can be used as a thin client to connect with the daemon running on your Whatbox slot. It is a more reliable way to interact with Deluge.

  1. Download version 2.0+ and install Deluge.
  2. Run Deluge
  3. Go to "Edit -> Preferences -> Interface" and choose "Thin Client".
  4. Restart Deluge. You should now see a connection manager box pop up.
  5. Remove the localhost daemon.
  6. Click "Add" and enter your server next to hostname: server.whatbox.ca
  7. Enter the port your Deluge daemon is running on
    (The port can be found on your Slot Info page)
  8. Enter your username and slot password
  9. Click "Add" to add your server's daemon.
  10. Click "Connect" and the connection manager pop up box should disappear.

Congratulations! You can now access Deluge on your Whatbox slot via the GTK UI.

Tunnel the GTK+ Thin Client's Connection

All communication between the GTK UI and daemon is encrypted using an automatically generated self-signed certificate so SSH tunneling is not a requirement.

  1. Follow the instructions for setting up an SSH Tunnel
  2. Create a new forwarded port. For Windows users using KiTTY (or PuTTY), the source port will be your daemon's port (check the "Info" page to get your daemon port). The destination will be where ##### is your daemon port again. Unlike the SSH Tunneling wiki article, you will set this to be a local port forward, not dynamic. Lastly, make sure that the "Local ports accept connections from other hosts checkbox" is checked.
  3. Create a new connection in the thin client's connection manager. The only difference in the above instructions for the GTK+ Thin Client is that you will enter for the hostname rather than your server's hostname.
    You will need to have the SSH tunnel active if you wish to connect to your remote daemon.

Enable SSL (optional)

HTTPS for Deluge's WebUI is an either/or scenario; You can either solely access the WebUI through HTTP, or you can solely access it through HTTPS. To do this, you will be creating a self-signed certificate, so note that your web browser might say that the connection is untrusted.

  1. SSH into your slot.
  2. Create the self-signed certificate. openssl req -new -x509 -nodes -out ~/.config/deluge/ssl/deluge.crt -keyout ~/.config/deluge/ssl/deluge.key -days 365
  3. Stop all running deluge processes. killall deluged; killall deluge-web
  4. Open Deluge's WebUI configuration file in a text editor. nano ~/.config/deluge/web.conf
  5. Change the following lines:
    "pkey": "ssl/daemon.pkey", to "pkey": "ssl/deluge.key",
    "cert": "ssl/daemon.cert", to "cert": "ssl/deluge.crt",
    "https": false, to "https": true,
  6. Save the configuration file. Ctrl+x if you used the nano text editor like above.
  7. Start the Deluge processes again, either from your Manage page, or in SSH: deluged; deluge-web --fork Refresh the manage page and you will find the WebUI hyperlink to appropriately adjust for the usage of SSL.


The console user interface offers a convenient way to control Deluge over SSH. The deluge-console can be started by executing deluge-console through SSH.

For more information, take a look at the full Deluge console documentation.


Transdroid is an open-source application for managing torrents from Android devices. It is able to connect rTorrent, Deluge and Transmission.

For installation instructions and more information take a look at the main article.

Configuration and log

All the interfaces should provide a way to change Deluge's settings. If you want, you can edit the core settings file. It is located at ~/.config/deluge/core.conf. Stop the "deluged" process before editing this file. Logs are also stored in this location.

Performance tuning

Deluge defaults should work quite well even if you have many torrents and nodes. If you suspect your speed is lower than it should be, check the cache command on deluge-console: it will give you information such as the read_hit_ratio (the higher it is, the better: a value of 1 would mean you're always reading from memory, so that disk slowness doesn't affect your seeding).

The Deluge wiki has a page on bandwidth tweaking. Note it's mostly directed to ADSL users.