rTorrent is a quick and efficient BitTorrent client that uses, and is in development alongside, the libTorrent (not to be confused with libtorrent-rasterbar) library. It is written in C++ and uses the ncurses programming library, which means it uses a text user interface. When combined with a terminal multiplexer (e.g. GNU Screen or Tmux) and Secure Shell, it becomes a convenient remote BitTorrent client. This Docker image includes the popular ruTorrent web frontend to rTorrent for ease of use, as well as OpenVPN to ensure a secure and private connection to the Internet, including use of iptables to prevent IP leakage when the tunnel is down. Privoxy is also included to allow unfiltered access to index sites, to use Privoxy please point your application at http://<host ip>:8118.
Latest stable rTorrent release from Arch Linux.
Latest stable ruTorrent release from Arch Linux AUR.
Latest GitHub commit to master branch for Flood.
Latest stable OpenVPN release from Arch Linux repo.
Latest stable Privoxy release from Arch Linux repo.
docker run -d \ --cap-add=NET_ADMIN \ -p 9080:9080 \ -p 9443:9443 \ -p 8118:8118 \ -p 3000:3000 \ --name=<container name> \ -v <path for data files>:/data \ -v <path for config files>:/config \ -v /etc/localtime:/etc/localtime:ro \ -e VPN_ENABLED=<yes|no> \ -e VPN_USER=<vpn username> \ -e VPN_PASS=<vpn password> \ -e VPN_PROV=<pia|airvpn|custom> \ -e VPN_OPTIONS=<additional openvpn cli options> \ -e STRICT_PORT_FORWARD=<yes|no> \ -e ENABLE_PRIVOXY=<yes|no> \ -e ENABLE_FLOOD=<yes|no|both> \ -e ENABLE_AUTODL_IRSSI=<yes|no> \ -e LAN_NETWORK=<lan ipv4 network>/<cidr notation> \ -e NAME_SERVERS=<name server ip(s)> \ -e DEBUG=<true|false> \ -e PHP_TZ=<php timezone> \ -e UMASK=<umask for created files> \ -e PUID=<uid for user> \ -e PGID=<gid for user> \ binhex/arch-rtorrentvpn
Please replace all user variables in the above command defined by <> with the correct values.
Access ruTorrent (web ui)
Access Flood (web ui)
Note:- Requires user to enable Flood via container env var (ENABLE_FLOOD).
docker run -d \ --cap-add=NET_ADMIN \ -p 9080:9080 \ -p 9443:9443 \ -p 8118:8118 \ -p 3000:3000 \ --name=rtorrentvpn \ -v /root/docker/data:/data \ -v /root/docker/config:/config \ -v /etc/localtime:/etc/localtime:ro \ -e VPN_ENABLED=yes \ -e VPN_USER=myusername \ -e VPN_PASS=mypassword \ -e VPN_PROV=pia \ -e STRICT_PORT_FORWARD=yes \ -e ENABLE_PRIVOXY=yes \ -e ENABLE_FLOOD=yes \ -e ENABLE_AUTODL_IRSSI=yes \ -e LAN_NETWORK=192.168.1.0/24 \ -e NAME_SERVERS=184.108.40.206,220.127.116.11,18.104.22.168,22.214.171.124,126.96.36.199,188.8.131.52,184.108.40.206,220.127.116.11 \ -e DEBUG=false \ -e PHP_TZ=UTC \ -e UMASK=000 \ -e PUID=0 \ -e PGID=0 \ binhex/arch-rtorrentvpn
AirVPN users will need to generate a unique OpenVPN configuration file by using the following link https://airvpn.org/generator/
- Please select Linux and then choose the country you want to connect to
- Save the ovpn file to somewhere safe
- Start the rtorrentvpn docker to create the folder structure
- Stop rtorrentvpn docker and copy the saved ovpn file to the /config/openvpn/ folder on the host
- Start rtorrentvpn docker
- Check supervisor.log to make sure you are connected to the tunnel
AirVPN users will also need to create a port forward by using the following link https://airvpn.org/ports/ and clicking Add. This port will need to be specified in the rTorrent configuration file located at /config/rtorrent/config/rtorrent.rc with the option
port_range = <start incoming port>-<end incoming port> and
port_random = no.
rTorrent example config
port_range = 49400-49400 port_random = no
docker run -d \ --cap-add=NET_ADMIN \ -p 9080:9080 \ -p 9443:9443 \ -p 8118:8118 \ -p 3000:3000 \ --name=rtorrentvpn \ -v /root/docker/data:/data \ -v /root/docker/config:/config \ -v /etc/localtime:/etc/localtime:ro \ -e VPN_ENABLED=yes \ -e VPN_PROV=airvpn \ -e ENABLE_PRIVOXY=yes \ -e ENABLE_FLOOD=yes \ -e ENABLE_AUTODL_IRSSI=yes \ -e LAN_NETWORK=192.168.1.0/24 \ -e NAME_SERVERS=18.104.22.168,22.214.171.124,126.96.36.199,188.8.131.52,184.108.40.206,220.127.116.11 \ -e DEBUG=false \ -e PHP_TZ=UTC \ -e UMASK=000 \ -e PUID=0 \ -e PGID=0 \ binhex/arch-rtorrentvpn
Please note this Docker image does not include the required OpenVPN configuration file and certificates. These will typically be downloaded from your VPN providers website (look for OpenVPN configuration files), and generally are zipped.
PIA users - The URL to download the OpenVPN configuration files and certs is:-
Once you have downloaded the zip (normally a zip as they contain multiple ovpn files) then extract it to /config/openvpn/ folder (if that folder doesn't exist then start and stop the docker container to force the creation of the folder).
If there are multiple ovpn files then please delete the ones you don't want to use (normally filename follows location of the endpoint) leaving just a single ovpn file and the certificates referenced in the ovpn file (certificates will normally have a crt and/or pem extension).
User ID (PUID) and Group ID (PGID) can be found by issuing the following command for the user you want to run the container as:-
If you want to create an additional user account for ruTorrent webui then please execute the following on the host:-
docker exec -it <container name> /home/nobody/createuser.sh <username to create>
If you want to delete a user account (or change the password for an account) then please execute the following on the host:-
docker exec -it <container name> /home/nobody/deluser.sh <username to delete>
If you do not define the PHP timezone you may see issues with the ruTorrent Scheduler plugin, please make sure you set the PHP timezone by specifying this using the environment variable PHP_TZ. Valid timezone values can be found here, http://php.net/manual/en/timezones.php
If you appreciate my work, then please consider buying me a beer :D