Version 15 (modified by Cas, 12 years ago) (diff)


Thin Client

  1. GTK UI
    1. Server Setup
      1. Enable Remote Connection
      2. Restart Daemon
      3. Verify IP Addresses
    2. Client Setup
      1. Create SSH Tunnel
  2. Web UI
    1. Server Setup
    2. Client Setup

Deluge can be setup in such a way that several machines (clients) can control deluge (daemon) on a central machine (server) through one of deluge's UI. For Deluge 1.2 upwards, all communication between the GTK UI and daemon is encrypted so SSH tunnelling is not a requirement.

The server setup sections are written for a headless linux server although they could be adapted for other platforms. The client setup sections are platform independent.

Note: Both the client and the server need to be similar versions, i.e. both 1.2.x or both 1.3.x.


Server Setup

  1. Install Deluge (including deluged) on the server.
  2. Run deluged, the Deluge daemon: (You may wish to enable logging and/or use an InitScript)
  3. Add a user and password to the authentication file (this does not have to be your server's user/pass):
    echo "username:password:level" >> ~/.config/deluge/auth
    where "username" and "password" are the username and password you intend to use and "level" is your desired authentication level. For example:
    echo "bob:letMEin:10" >> ~/.config/deluge/auth

See UserGuide/Authentication for more information on authentication levels.

Enable Remote Connection

We will use deluge-console to configure deluged to accept connections from machines other than localhost.

Note: These steps can be omitted if you are using SSH Tunnelling.

  1. Run the Console UI:
  2. Enable remote connections and check it was set properly:
    config -s allow_remote True
    config allow_remote
  3. Exit the Console UI:

Restart Daemon

pkill deluged

Verify IP Addresses

You will need to know the server IP address for setting up the client(s). If you do not know your server's private or public IP address use these commands:

  1. Private IP:
    ifconfig | grep -e 'inet addr' | grep -v '' | cut -f2 -d':' | cut -f1 -d' '
  1. Public IP:

Congratulations! The server is now setup for remote GTK UI access.

Client Setup

  1. Run deluge.
  2. Go to "Preferences -> Interface" and untick 'Classic Mode' to disable it.
  3. Restart deluge. You should now see the Connection Manager pop up.
  4. Remove the localhost daemon.
  5. Click "Add" and for 'Hostname' enter your server's IP. (For SSH Tunnelling use '' and Create SSH Tunnel before continuing)
  6. Leave the Port as default (58846).
  7. Enter the Username & Password you added to the authentication file then finish by clicking 'Add'. A green tick should now appear as the status for the host you just added.
  8. (Optional) Expand "Options" and select "Automatically connect to selected host on startup" and "Do not show this dialog on start-up".
  9. Click "Connect" and the connection manager pop up box should disappear.

Congratulations! You can now access deluge on the server via the GTK UI.

Create SSH Tunnel

  1. Open up a terminal and enter the following, replacing <server> with the public IP of your server.
    ssh -fNL <server>

Note: We use instead of localhost so that deluge client knows that we are connecting to a remote daemon.

Note: If you get the error:

bind: Can't assign requested address

You need to add as an alias for the loopback device:

sudo ifconfig lo0 add

Web UI

Server Setup

  1. Install Deluge on the server.
  2. Run the deluge daemon (You may want to enable logging and/or use an InitScript.):
  3. Run deluge Web UI:
    You can also use the --fork option to have the deluge-web process run in the background and again, you may want to use an InitScript.
    deluge-web --fork
  1. (Optional) If you do not know your server's public ip, run:

Congratulations! The server is now setup for web UI access.

Client Setup

  1. Open your preferred web browser.
  2. Open the URL:
    where <server> is either the private or public ip of the server depending if you are on the server's private network or not.
  1. Default password is "deluge".

Congratulations! You can now access deluge on the server via the web UI.