From Gentoo Wiki
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

Deluge is an open-source, cross platform BitTorrent client. It features a GTK-based GUI, a command line interface, a web interface, and also supports remote clients. Deluge is written in Python 3.


USE flags

USE flags for net-p2p/deluge BitTorrent client with a client/server model

console Enable default console UI
gui Enable support for a graphical user interface
libnotify Enable desktop notification support
sound Enable sound support
test Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently)
webinterface Install dependencies needed for the web interface


root #emerge --ask net-p2p/deluge


Headless server

  1. Start the deluged daemon
    root #/etc/init.d/deluged start
    • To start the daemon on system launch, issue:
      root #rc-update add deluged default
  2. Make sure that Deluge is built with the console USE flag.
  3. Enable remote connections
    • Switch to the deluge user
      root #su --shell /bin/bash deluge
    • Open the deluge cli
      deluge $deluge-console
    • Change the configuration value
      >>>config -s allow_remote True
    • Leave the deluge cli
  4. Set the server username and password
    deluge $echo "Larry:GentooLinuxrocks" >> ~/.config/deluge/auth
  5. Restart deluged
    root #/etc/init.d/deluged restart

Deluge web UI

  1. Make sure that Deluge is built with the webinterface USE flag.
  2. Configure deluge-web
    FILE /etc/conf.d/deluge-webSetting up the UI
    # /etc/conf.d/deluge-web
    # Change this to the user:group that should run deluge.
    DELUGE_WEB_OPTS="-p 8112 --interface "<ipv6 address or ipv4 address to bind>" -L=debug -c /var/lib/deluge -l /var/lib/deluge/deluge-web.log"
    • Starting the daemon on system launch can be done with
      root #rc-update add deluge-web default

Adding SSL support to UI

  1. Make sure the certificate and key files are PEM encoded, and copy certificate.crt.pem and certificate.key.pem to the deluge home directory. Usually this is the /var/lib/deluge directory by default.
  2. Edit the web.conf file.
    FILE /var/lib/deluge/web.confAdding SSL support
        "file": 2,
        "format": 1
        "base": "/",
        "cert": "ssl/seedbox.cert",
        "pkey": "ssl/seedbox.key",
If the CA certificates are required, combine them (aka make a bundle with certificate and CA's) in the certificate.crt.pem file.

Remote GTK client

  1. Make sure that Deluge is built with the gui USE flag.
  2. Launch deluge-gtk, go to Edit -> Preferences -> Interface and disable classic mode, then restart deluge-gtk.
  3. Add the headless server to the connection manager, filling in the username, password, IP address and port. Then click connect.
  4. Optionally, add the server as a default to hide the Connection Manager prompt.

External resources