From Gentoo Wiki
Jump to: navigation, search
This article is a stub. You can help by expanding it.

Deluge is an open-source, cross platform BitTorrent client. It features a GTK 3 based GUI, a command line interface, a web interface and also 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
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


root #emerge --ask net-p2p/deluge


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_UMASK="0002"
    # DELUGED_OPTS="-p 58846"
    DELUGEUI_OPTS="-u web"
  3. Start the deluged daemon
    root #/etc/init.d/deluged start
    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
  5. Set the server username and password
    deluge $echo "myUsername:securePassword" >> ~/.config/deluge/auth
  6. Restart deluged
    root #/etc/init.d/deluged restart

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