# pacman -S deluge
The gtk UI requires additional dependencies as does the webui. Inspect the pacman output to determine which are right for the intended application.
python2-notify: libnotify notifications pygtk: needed for gtk ui librsvg: needed for gtk ui python2-mako: needed for web ui
Deluge can run as a system daemon which is accessible to any system user or it can run in a non-daemon mode. The focus of this article is on the daemon mode of operation.
/srv/deluge/.config/manually or from the
/usr/bin/deluge-console. The rest of this guide is written using the gtk client to do this from convenience of a GUI.
Start the deluge backend daemon like any other systemd service:
# systemd start deluged
Create a User
To allow interaction with the daemon, create a user:password:level in
# echo "delugeuser:p422WoRd:10" >> /srv/deluge/.config/deluge/auth
The number 10 corresponds to a level of 'Admin.' Refer to the following table for additional values:
|Level Name||Level Value|
- Load the gtk client
- Disable classic mode from the Edit>Preferences>Interface.
A restart of the client is required for these changes to take effect. Exit the client and reload it.
- Setup the client to point to the daemon from Edit>Connection Manager.
- Delete the dummy server by hightlighting it and clicking the "Remove" button.
- Create an entry to the daemon via the "Add" button populating the resulting dialog with either the IP address or the word "localhost" as the hostname. Populate the "Username" and "Password" fields with the username and password used in the daemons setup.
- Click the "+ Add" button.
If the correct credentials were populated, a green light should appear options for interaction adjacent to the name of the server. To connect, hit the "Connect" button.
Users can now configure their server from the GUI. Most of the options are self explanatory and intuitive. More details are available on the official Deluge wiki for details.
If the expectation exists to allow access from other machines, be sure to enable Preferences>Daemon>Connections>Allow Remote Connections.
Web UI Setup (Optional)
As previously mentioned, deluge has a native web UI. To run it, simply start the web-daemon:
# systemctl start deluge-web
Point a browser to
http://localhost:8112. Substitute the word localhost with an IP address if the server is elsewhere.
When asked for a password, enter "deluge" as it is the default password.
The preferences in the web UI is highly similar to the gtk UI. As explained in the previous section, edit the connection manager and define an entry to the daemon using the same credentials used in the setup step. Once finished, users are free to remove the dummy server entry.
In case you want SSL for the web UI, you need to generate a new cert/key set. To do this, first stop the web UI daemon and then append to
# openssl req -new -x509 -nodes -out deluge.cert.pem -keyout deluge.key.pem
Next you need to edit
/srv/deluge/.config/deluge/web.conf and change the pkey and cert configuration directives to use your new self-signed certificates and also enable SSL:
... "pkey": "ssl/deluge.key.pem", ... "cert": "ssl/deluge.cert.pem", ... "https": true,
Afterwards just start the web UI daemon again.
As of this writing, it is possible to use ProxyPass and ProxyPassReverse with Apache to run your Deluge web UI with a web server. To do so, add the following lines to your
Uncomment the Virtual Hosts line:
That is all the editing that needs to be done for the
httpd.conf. Next, navigate to the
extra/ folder and edit the
httpd-vhosts.conf file. Append to the file, the following:
<VirtualHost *:80> ServerAlias subdomain.example.com ProxyRequests off ProxyPass / http://127.0.0.1:8112/ ProxyPassReverse / http://127.0.0.1:8112/ </VirtualHost>
Magnet Links Are Broken with Chromium
The following command should return "deluge.desktop":
$ xdg-mime query default "x-scheme-handler/magnet"
If it returns a null, run this command:
$ xdg-mime default deluge.desktop application/x-bittorrent x-scheme-handler/magnet
Downloads don't start
As of libtorrent-rasterbar version 0.16, Deluge will not download torrents that are added by a magnet link.
Downgrading libtorrent-rasterbar to 1:0.16.3-1 should fix it. Use the following PKGBUILD: https://projects.archlinux.org/svntogit/packages.git/tree/trunk?h=packages/libtorrent-rasterbar&id=da6a845f1f66026c2e0df71e8728ab0d8fd660b0
Web UI doesn't store settings
For some yet unknown reason, the web interface with Deluge 1.3.3 refuses to properly store the incoming (listen) ports configuration. This can manually be edited in core.conf. The Deluge bugtracker mentions this is fixed, it is not in 1.3.3.
... "enc_prefer_rc4": true, "listen_ports": [ 49160, 49249 ], "dht": false, ...
Daemon won't start on fresh install
There seems to be an issue creating a folder with the correct permissions when the package installs, try:
# chmod u+x /srv/deluge