Gentoo Wiki


This article is part of the HOWTO series.
Installation Kernel & Hardware Networks Portage Software System X Server Gaming Non-x86 Emulators Misc
Deluge main screen
Deluge main screen



Deluge is a lightweight, free, cross-platform BitTorrent client. You can find out more at [|].


The deluge package is net-p2p/deluge

Emerge with ask and verbose options to check out what dependencies are going to get pulled in and which use flags will be used.

emerge -av net-p2p/deluge

Currently the only use flag defined directly on the package is libnotify. If you're happy hit Y, if not hit N and go and make any changes you need to your use flags.

Once emerged you should be able to run deluge using the command Deluge. At the moment help appears limited - there's no man page and --help doesn't give much information.


Deluge stores it's configuration in the ~/.config/deluge/ directory.

The first time you run deluge it *should* run the First Launch Configuration wizard

Note: If you get a D-Bus error message which includes the line "Failed to open "/var/lib/dbus/machine-id" " check that D-Bus is running. This should only be an issue if you are running on a remote machine that is not running X.
Note: If you get error messages such as

"The program 'deluge' received an X Window System error. This probably reflects a bug in the program. The error was 'BadAccess (attempt to access private resource denied)'."

just run deluge again - it should work the second time.

First Launch Configuration wizard

The First Launch Configuration wizard will run you through the basic configuration settings in 4 steps.

Step 1 - Intro

First Launch Configuration wizard - step 1

Step 2 - Listening Ports

First Launch Configuration wizard - step 2

Specify the port range for Deluge to listen on for incoming connections. You will need to ensure these ports are allowed through your firewall - TODO: find a good reference in the wiki of how to do this.

Step 3 - Where to save files

First Launch Configuration wizard - step 3

By default Deluge will set itself up to save files in the users home folder.

Step 4 - Bandwidth settings

First Launch Configuration wizard - step 4

Step 5 - Feedback

First Launch Configuration wizard - step 5

Automatic upgrades

Deluge includes an update checker. If a newer version of the application is detected you will see this message.

New version detected popup

Note: I elected not to upgrade so I can't give any information on what happens if you say yes or how compatible the process is with Gentoo / Portage. When I've had more of a chance to play and am feeling brave I may give it a go. If you try it please add you experiences here.

See Also

Retrieved from ""

Last modified: Thu, 04 Sep 2008 01:07:00 +0000 Hits: 784