Deluge

Bytesized's favorite torrent client. Deluge is a lightweight, feature-rich BitTorrent client with a web interface and a thin client GTK interface. Every Bytesized Appbox comes with Deluge pre-configured and ready to use.

Changelog

12th April 2026 — Updated guide to reflect current Deluge v2+ and modern plugins.

13th March 2015 — Updated guide to running two separate daemons on the same box.

23rd July 2014 — Deluge now always downloads to ~/torrents/data. This improves reseeding and cross-seeding workflow.

21st July 2014 — Filebot is now triggered even without assigning a label.

19th July 2014 — Deluge now uses Filebot to index and rename files by default. To make content show up in Plex, assign a movies or tv label — files will be automatically renamed to a Plex-compatible format after download completes.

Tips and tricks

Transdroid

See the dedicated Transdroid guide for setup instructions.

Updating Deluge to a specific version

To change the version of Deluge installed on your box, edit ~/.bysh_versions via FTP, SSH or VNC. Find the line DELUGE_VERSION=x.x.x and change it to the desired version, or set it to latest to always use the latest version Bytesized offers:

DELUGE_VERSION=latest

Save the file, then stop and start the Deluge app from your Account Details page for the change to take effect.

Disable auto-renaming (Filebot / olaris-rename)

If you don't want downloaded files to be analysed, renamed or extracted automatically, you can restrict processing to torrents with a specific label.

See the whitelist/blacklist guide for instructions.

Remote Torrent Adder

See the dedicated Remote Torrent Adder guide for setup instructions.

Creating torrent files

See the dedicated mktorrent guide for instructions.

Multiple Deluge Daemons

While the Bytesized app installer handles a single Deluge instance flawlessly, you can run a second discrete daemon via SSH. Note that you will only be able to start and stop this second daemon from the command line.

Step 1 — Duplicate the config directory

cp -r ~/.config/deluge ~/.config/deluge2

If you don't want to duplicate existing torrents in the second instance, remove the state files:

rm ~/.config/deluge2/state/*

Step 2 — Change the ports

Open ~/.config/deluge2/core.conf and find daemon_port — increment it by 1 (or any unused value). Do the same for web_port.

Step 3 — Start the second daemon

deluged --config ~/.config/deluge2

If you get an error about a daemon already running on that config, run:

killall deluged
deluged --config ~/.config/deluge2

⚠️ killall deluged will also kill your primary daemon. Restart it from your Bytesized dashboard afterwards.

Step 4 — Configure the auth file

Open ~/.config/deluge2/auth and add your credentials on a new line:

username:password:10

You can now connect to the second daemon from the Deluge web UI or Thin Client using the same address but with the new port and the credentials you defined.

Troubleshooting

Download speeds oscillate between 100MB/s and sub 10MB/s

This is normal Deluge behaviour. Deluge uses its own internal cache — when the cache fills up it pauses downloading while it flushes to disk, causing the speed drop. Once flushed, speeds return to normal. rTorrent uses Linux's native caching and doesn't exhibit this pattern, but benchmarks show Deluge is still faster overall.

Disk space counter

Deluge's built-in disk space counter is designed for single-user systems and is not accurate on shared boxes. Use the disk space counter on your Bytesized dashboard as the only source of truth.

Web interface password change

Your Deluge web interface password is displayed on your box dashboard by default. To change it, go to Preferences → Interface in the Deluge web UI and use the password change form.

⚠️ Warning: If you change your password, Bytesized support will no longer be able to access your Deluge instance to assist you efficiently.