| 1 | = Thin Client = |
| 2 | |
| 3 | [[PageOutline(2-4,,inline)]] |
| 4 | |
| 5 | Deluge can be setup in such a way that several machines (clients) can control deluge on a central machine (server) through one of deluge's UI. |
| 6 | When the client is not on the same private network as the server, it is recommended that only the Web UI is used or that the GTK UI is used with SSH tunneling. |
| 7 | |
| 8 | The server setup sections are written for a headless linux server although they could be adapted for other platforms. |
| 9 | The client setup sections are platform independent. |
| 10 | |
| 11 | == GTK UI == |
| 12 | |
| 13 | === Server Setup === |
| 14 | |
| 15 | ==== Without SSH Tunneling ==== |
| 16 | |
| 17 | 1. [wiki:Installing Install Deluge] on the server. |
| 18 | 1. Run the deluge daemon: |
| 19 | {{{ |
| 20 | #!sh |
| 21 | deluged |
| 22 | }}} |
| 23 | You may want to [wiki:Faq#HowdoIstartthedaemonwithloggingenabled enable logging] and/or use an InitScript. |
| 24 | 1. Run the Console UI: |
| 25 | {{{ |
| 26 | #!sh |
| 27 | deluge -u console |
| 28 | }}} |
| 29 | 1. Enable remote connections: |
| 30 | {{{ |
| 31 | config -s allow_remote True |
| 32 | }}} |
| 33 | This allows other machines besides the localhost to be able to connect to the daemon using the GTK UI. |
| 34 | 1. Double check it was set properly: |
| 35 | {{{ |
| 36 | config allow_remote |
| 37 | }}} |
| 38 | 1. Exit the Console UI: |
| 39 | {{{ |
| 40 | exit |
| 41 | }}} |
| 42 | 1. Shutdown the daemon: |
| 43 | {{{ |
| 44 | #!sh |
| 45 | killall deluged |
| 46 | }}} |
| 47 | 1. Add yourself to the authentication file: |
| 48 | {{{ |
| 49 | #!sh |
| 50 | echo "<username>:<password>" >> ~/.config/deluge/auth |
| 51 | }}} |
| 52 | where <username> and <password> are the username and password you intend to use. |
| 53 | |
| 54 | Note: the username and password can be anything - they do not necessarily have to be your server's username and password. |
| 55 | |
| 56 | 1. Restart the daemon: |
| 57 | {{{ |
| 58 | #!sh |
| 59 | deluged |
| 60 | }}} |
| 61 | 1. (Optional) If you do not know your server's private ip, run: |
| 62 | {{{ |
| 63 | #!sh |
| 64 | ifconfig | grep -e 'inet addr' | grep -v '127.0.0.1' | cut -f2 -d':' | cut -f1 -d' ' |
| 65 | }}} |
| 66 | You will need to know this for setting up the client(s). |
| 67 | |
| 68 | Congratulations! The server is now setup for GTK UI access. |
| 69 | |
| 70 | ==== With SSH Tunneling ==== |
| 71 | |
| 72 | 1. [wiki:Installing Install Deluge] on the server. |
| 73 | 1. Run the deluge daemon: |
| 74 | {{{ |
| 75 | #!sh |
| 76 | deluged |
| 77 | }}} |
| 78 | You may want to [wiki:Faq#HowdoIstartthedaemonwithloggingenabled enable logging] and/or use an InitScript. |
| 79 | 1. Add yourself to the authentication file: |
| 80 | {{{ |
| 81 | #!sh |
| 82 | echo "<username>:<password>" >> ~/.config/deluge/auth |
| 83 | }}} |
| 84 | where <username> and <password> are the username and password you intend to use. |
| 85 | |
| 86 | Note: the username and password can be anything - they do not necessarily have to be your server's username and password. |
| 87 | |
| 88 | 1. Restart the daemon: |
| 89 | {{{ |
| 90 | #!sh |
| 91 | deluged |
| 92 | }}} |
| 93 | 1. (Optional) If you do not know your server's public ip, run: |
| 94 | {{{ |
| 95 | #!sh |
| 96 | wget www.whatismyip.com/automation/n09230945.asp -O - 2> /dev/null && echo |
| 97 | }}} |
| 98 | You will need to know this for setting up the client(s). |
| 99 | |
| 100 | Congratulations! The server is now setup for GTK UI access using a SSH tunnel. |
| 101 | |
| 102 | === Client Setup === |
| 103 | |
| 104 | ==== Without SSH Tunneling ==== |
| 105 | 1. Run deluge. |
| 106 | 1. Go to "Preferences -> Interface" and untick "Enable" under "Classic Mode". |
| 107 | 1. Restart deluge. You should now see a connection manager box pop up. |
| 108 | 1. Remove the localhost daemon. |
| 109 | 1. Click "Add" and enter your server's ip. |
| 110 | 1. Leave the port as default. |
| 111 | 1. Enter the username & password you added to the authentication file. |
| 112 | 1. Click "Add" to add your server's daemon. |
| 113 | You should now see a green tick as the status for the host you just added. |
| 114 | 1. (Optional) Expand "Options" and select "Automatically connect to selected host on startup" and "Do not show this dialog on start-up". |
| 115 | 1. Click "Connect" and the connection manager pop up box should disappear. |
| 116 | |
| 117 | Congratulations! You can now access deluge on the server via the GTK UI. |
| 118 | |
| 119 | ==== With SSH Tunneling ==== |
| 120 | 1. Open up a terminal and enter |
| 121 | {{{ |
| 122 | #!sh |
| 123 | ssh -fNL 58846:localhost:58846 <server> |
| 124 | }}} |
| 125 | Where <server> is the public ip of your server. |
| 126 | 1. Run deluge. |
| 127 | 1. Go to "Preferences -> Interface" and untick "Enable" under "Classic Mode". |
| 128 | 1. Restart deluge. You should now see a connection manager box pop up. |
| 129 | 1. Remove the localhost daemon. |
| 130 | 1. Click "Add" and enter "localhost". |
| 131 | |
| 132 | 1. Leave the port as default. |
| 133 | 1. Enter the username & password you added to the authentication file. |
| 134 | 1. Click "Add" to add your server's daemon. |
| 135 | You should now see a green tick as the status for the host you just added. |
| 136 | 1. (Optional) Expand "Options" and select "Automatically connect to selected host on startup" and "Do not show this dialog on start-up". |
| 137 | 1. Click "Connect" and the connection manager pop up box should disappear. |
| 138 | |
| 139 | Congratulations! You can now access deluge on the server via the GTK UI and SSH tunneling. |
| 140 | |
| 141 | == Web UI == |
| 142 | === Server Setup === |
| 143 | |
| 144 | 1. [wiki:Installing Install Deluge] on the server. |
| 145 | 1. Run the deluge daemon: |
| 146 | {{{ |
| 147 | #!sh |
| 148 | deluged |
| 149 | }}} |
| 150 | You may want to [wiki:Faq#HowdoIstartthedaemonwithloggingenabled enable logging] and/or use an InitScript. |
| 151 | 1. Run deluge Web UI: |
| 152 | {{{ |
| 153 | #!sh |
| 154 | deluge -u web |
| 155 | }}} |
| 156 | Again, you may want to use an InitScript. |
| 157 | 1. (Optional) If you do not know your server's public ip, run: |
| 158 | {{{ |
| 159 | #!sh |
| 160 | wget www.whatismyip.com/automation/n09230945.asp -O - 2> /dev/null && echo |
| 161 | }}} |
| 162 | |
| 163 | Congratulations! The server is now setup for web UI access. |
| 164 | |
| 165 | === Client Setup === |
| 166 | |
| 167 | 1. Open your preferred web browser. |
| 168 | 1. Open the URL: |
| 169 | {{{ |
| 170 | http://<server>:8112 |
| 171 | }}} |
| 172 | where <server> is either the private or public ip of the server depending if you are on the server's private network or not. |
| 173 | |
| 174 | 1. Default password is "deluge". |
| 175 | |
| 176 | Congratulations! You can now access deluge on the server via the web UI. |