| 90 | | You can find an example [http://libtorrent.rakshasa.no/browser/trunk/rtorrent/doc/rtorrent.rc?rev=latest .rtorrent.rc] file. |
| 91 | | Open .rtorrent.rc, and edit it (for each user): |
| 92 | | * add this line to your .rtorrent.rc "scgi_port = 127.0.0.1:12345" where 12345 can be replaced by any port of your choice |
| 93 | | * and restart rtorrent |
| 94 | | * if you have more than one user, set a different port for each user's .rtorrent.rc file (be aware, to set different session directories for the users) |
| 95 | | * set your download directory |
| 96 | | * make sure, you have your session directory set and it exists, so rtorrent will remember your torrents after it's restarted |
| | 91 | You can find an example [http://libtorrent.rakshasa.no/browser/trunk/rtorrent/doc/rtorrent.rc?rev=latest .rtorrent.rc] file on the rTorrent page.[[BR]] |
| | 92 | Edit your .rtorrent.rc (create on into your home directory, if it's a fresh install): |
| | 93 | * set up how rtorrent should listen for connections (there are 3 ways to do this) |
| | 94 | * to use a unix socket, add the line "scgi_local = ~/torrent/.socket/rpc.socket" (this is the recommended way) |
| | 95 | * to listen for connections from localhost on port 12345 add the line "scgi_port = :12345" |
| | 96 | * to listen for connections from a specific interface on port 12345 add the line "scgi_port = 123.123.123.123:12345" |
| | 97 | * if you have more than one user, set a different scgi_port/scgi_local value in each user's .rtorrent.rc file |
| | 98 | * set your download directory "directory = ~/torrent/ |
| | 99 | * absolute paths are always welcome, however rTWi should handle relative paths, like above (if it does not, submit a [/rtwi/newticket ticket] |
| | 100 | * make sure, you have your session directory set and it exists, so rtorrent will remember your torrents after it's restarted "session = ~/torrent/.session" (be aware to set different session directories for the users) |
| 107 | | If everything went fine, extract the rtwi-xxxxxx.tar.gz to some place where your webserver can see it. |
| 108 | | In case it's your first install, open the freshly extracted includes/config.php.inc, and edit the next lines: |
| 109 | | * set the $url!["base"] variable to your rTWi installation's URL (without index file, and with a trailing slash, so something like ''!http://mysite.com/rtwi/'') |
| 110 | | * if your php interpreter does not handle .html files (only .php) set the $url!["index"] variable to "index.php", and rename the index.html to index.php |
| | 111 | Download the [/rtwi/downloads/rtwi-latest.tar.gz latest rTWi] from the [wiki:Download Download] section, extract it to some place where your webserver can see it. |
| | 112 | Edit your configuration file (includes/rtwi.conf): |
| | 113 | * set the "base" variable to your rTWi installation's URL (without index file, and with a trailing slash) "base = http://example.com/" |
| | 114 | * set the "user_conf" variable to the path of your user.conf file (it's always safe, to keep it outside your webroot) |
| | 115 | * if your want to rename your index.php and/or input.php you need to set the "index" and/or "input" variable(s) |
| 114 | | * find row 32, and change it: |
| 115 | | * uncomment the line (delete the slashes from the beginning of the line) |
| 116 | | * replace "username" with the actual linux username |
| 117 | | * replace "1234567890abcdef1234567890abcdef12345678" with the users' sha1 hash of the choosen password for the webui (you can generate the sha1 hash [http://www.johnmaguire.us/tools/hashcalc/index.php online]) |
| 118 | | * replace "12345", with the port, you've set in the user's .rtorrent.rc file |
| 119 | | * keep the quotes in the last three steps |
| | 119 | Edit your users.conf file: |
| | 120 | * create a new section for every user "[user1]" (this will be your login name - this must be the *nix username) |
| | 121 | * set the address rTWi can connect to the user's rTorrent (there are 3 ways to do it) |
| | 122 | * if you're using a unix socket enter "address = !unix://~/torrent/.socket/rpc.socket" |
| | 123 | * if you're using scgi_port enter "address = 123.123.123.123:12345" ("address = :12345" works for localhost) |
| | 124 | * if you're using an SCGI gateway enter "address = !http://example.com/RPC2" (also works when Basic HTTP Authentication is on for the URL) |
| | 125 | * enter "pass = 1234567890abcdef1234567890abcdef12345678" where the right side is the sha1 hash of the choosen password for the user (you can generate the sha1 hash [http://www.johnmaguire.us/tools/hashcalc/index.php online]) |
| | 126 | * If a value in the conf file contains any non-alphanumeric characters it needs to be enclosed in double-quotes (") |
| 122 | | $users = array( |
| 123 | | "user1" => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port" => "12345" ), |
| 124 | | "user2" => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port" => "12346" ), |
| 125 | | "user3" => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port" => "12347" ), |
| 126 | | ); |
| | 130 | [user1] |
| | 131 | address = "address = unix://~/torrent/.socket/rpc.socket" |
| | 132 | pass = "1234567890abcdef1234567890abcdef12345678" |
| | 133 | |
| | 134 | [user2] |
| | 135 | address = "123.123.123.123:12345" |
| | 136 | pass = "1234567890abcdef1234567890abcdef12345678" |
| | 137 | |
| | 138 | [user3] |
| | 139 | address = "http://example.com/RPC2" |
| | 140 | pass = "1234567890abcdef1234567890abcdef12345678" |
