Skip to content
Tigerbot Hesh edited this page Sep 1, 2020 · 18 revisions

rtorrent install

Quick installation

Since version 0.7.8 of rtorrent, most distros have compiled rtorrent with xmlrpc-c. If you are using a relatively current distro (e.g. Ubuntu 18.04LTS or newer) installation is as simple as using your package manager. It's recommended to use the latest version of rTorrent, so you can check your distro version in this way:

apt-get update
apt-cache show rtorrent | grep Version

If this version suits good for you, you can install with:

apt-get install rtorrent

Once installed you can proceed to configure rtorrent

Long installation

If you want the latest version of rTorrent, you can compile it by yourself. Only advanced users should do this.

Dependencies:

Compile and install xmlrpc-c

It's recommended that you use a newer version of xmlrpc-c. We use the svn stable version in this guide.

svn co http://svn.code.sf.net/p/xmlrpc-c/code/stable xmlrpc-c
cd xmlrpc-c
./configure
make
make install

Compile and install libtorrent

Now you can compile and install libtorrent as follows:

cd ~
wget http://rtorrent.net/downloads/libtorrent-0.13.8.tar.gz
tar -zxvf libtorrent-0.13.8.tar.gz
cd libtorrent-0.13.8
bash autogen.sh
./configure
make
make install

Compile and install rTorrent

Now you can compile and install rTorrent as follows:

cd ~
wget http://rtorrent.net/downloads/rtorrent-0.9.8.tar.gz
tar -zxvf rtorrent-0.9.8.tar.gz
cd rtorrent-0.9.8
bash autogen.sh
./configure --with-xmlrpc-c
make
make install

On a FreeBSD system with Ports installed, all of the above can be done with a single line of code:

cd /usr/ports/net-p2p/rtorrent/ && make install clean

rTorrent Configuration

rTorrent can be run as any user (or multiple users). Generally, it's a bad idea to run rtorrent as the root user, so create a unique user, and make sure to add a configuration file (.rtorrent.rc) in the home folder. According to Official rTorrent configuration guide, proceed in this way:

curl -Ls "https://raw.githubusercontent.com/wiki/rakshasa/rtorrent/CONFIG-Template.md" \
    | sed -ne "/^######/,/^### END/p" \
    | sed -re "s:/home/USERNAME:$HOME:" >~/.rtorrent.rc
mkdir -p ~/rtorrent/

Make sure to enable rpc socket, uncomment these lines of .rtorrent.rc

system.daemon.set = false
network.scgi.open_local = (cat,(session.path),rpc.socket)
execute.nothrow = chmod,770,(cat,(session.path),rpc.socket)

The rpc socket will be created at ~/rtorrent/.session/rpc.socket

Please note that newer version of rTorrent config file prefer to use rpc socket instead of host and SCGI port. This behaviour is recommended because it's easier and safer. If you prefer old behaviour, add this line to your config file:

network.scgi.open_port = 127.0.0.1:5000

rTorrent usage

If you have chosen to run rTorrent as an application (system.daemon.set = false), you can simply run the program to see if it works well:

rtorrent

It's better run rTorrent as a service (system.daemon.set = true). You can keep running program in background in this way:

daemonize $(which rtorrent)
Clone this wiki locally