Deluge

This article is a stub. You can help by expanding it.

Deluge is [[Article description::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.

Installation

USE flags

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

console Enable default console UI
geoip Add geoip support for country and city lookup based on IPs
gtk Add support for x11-libs/gtk+ (The GIMP Toolkit)
libnotify Enable desktop notification support
sound Enable sound support
webinterface Install dependencies needed for the web interface

Emerge

root #emerge --ask net-p2p/deluge

Configuration

Headless server

  1. Create a user
    root #useradd -m -g nogroup -s /bin/nologin deluge
  2. Configure deluged
    FILE /etc/conf.d/delugedSetting the user
    # /etc/conf.d/deluged
    # Change this to the user you want to run deluged as.
    # You may specify a group too, after a colon
    DELUGED_USER="deluge:nogroup"
    # DELUGED_UMASK="0002"
    # DELUGED_OPTS="-p 58846"
    DELUGEUI_START="false"
    DELUGEUI_OPTS="-u web"
    
  3. Start the deluged daemon
    root #/etc/init.d/deluged start
    Note
    Starting the daemon on system launch can be done with
    root #rc-update add deluged default
  4. Enable remote connections
    1. Switch to the deluge user
      root #su --shell /bin/bash deluge
    2. Open the deluge cli
      deluge $deluge-console
    3. Change the configuration value
      >>>config -s allow_remote True
    4. Leave the deluge cli
      >>>exit
  5. Set the server username and password
    deluge $echo "myUsername:securePassword" >> ~/.config/deluge/auth
  6. 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 you want to run deluged as.
    # You may specify a group too, after a colon
    DELUGE_WEB_USER="deluge:deluge"
    DELUGE_WEB_HOME="/var/lib/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"
    
Note
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 your certificate and key files are PEM encoded, and copy certificate.crt.pem, certificate.key.pem to your deluge home directory. Usually /var/lib/deluge.
  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",
    <snip>
    
Note
If you require to have the CA certificates as well, you need to 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 gtk USE flag.
  2. Launch deluge-gtk, go to Edit -> Preferences -> Interface and disable classic mode, then restart deluge-gtk.
  3. Add your 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

This article is issued from Gentoo. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.