This article will show you how to install and configure qBittorrent. qBittorrent can be used as an alternative to ruTorrent, Deluge or Transmission.

You'll need to execute some commands via SSH to use this software. There is a separate guide on how to connect to your slot via SSH. Commands are kept as simple as possible and in most cases will simply need to be copied and pasted into the terminal window (then executed by pressing the Enter key).

Installation - Auto

The following script will allow you to do the following things easily:

  1. Install the software
  2. Restart it - provides an error message if restarting not possible
  3. Uninstall qBittorrent

To run it, simply log in via SSH then copy and paste the following:

wget -qO ~/install.qbittorrent.sh https://bitbucket.org/feralio/wiki/raw/HEAD/src/wiki/software/qbittorrent/qbittorrent.sh && bash ~/install.qbittorrent.sh

Installation - Manual

qBittorrent requires several packages to be installed to your slot first. You can copy the entire block of commands below - they'll run automatically and you'll need to press enter on the last of the commands:

mkdir -p ~/bin ~/lib
wget -q http://ftp.nl.debian.org/debian/pool/main/b/boost1.62/libboost-chrono1.62.0_1.62.0+dfsg-4_amd64.deb && dpkg -x libboost-chrono1.62.0_1.62.0+dfsg-4_amd64.deb ~/deb-temp 
wget -q http://ftp.nl.debian.org/debian/pool/main/b/boost1.62/libboost-random1.62.0_1.62.0+dfsg-4_amd64.deb && dpkg -x libboost-random1.62.0_1.62.0+dfsg-4_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/b/boost1.62/libboost-system1.62.0_1.62.0+dfsg-4_amd64.deb && dpkg -x libboost-system1.62.0_1.62.0+dfsg-4_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/libt/libtorrent-rasterbar/libtorrent-rasterbar9_1.1.1-1+b1_amd64.deb && dpkg -x libtorrent-rasterbar9_1.1.1-1+b1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/p/pcre3/libpcre16-3_8.39-3_amd64.deb && dpkg -x libpcre16-3_8.39-3_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/o/openssl/libssl1.1_1.1.0j-1~deb9u1_amd64.deb && dpkg -x libssl1.1_1.1.0j-1~deb9u1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/d/double-conversion/libdouble-conversion1_2.0.1-4_amd64.deb && dpkg -x libdouble-conversion1_2.0.1-4_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/q/qtbase-opensource-src/libqt5core5a_5.7.1+dfsg-3+deb9u1_amd64.deb && dpkg -x libqt5core5a_5.7.1+dfsg-3+deb9u1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/q/qtbase-opensource-src/libqt5dbus5_5.7.1+dfsg-3+deb9u1_amd64.deb && dpkg -x libqt5dbus5_5.7.1+dfsg-3+deb9u1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/q/qtbase-opensource-src/libqt5network5_5.7.1+dfsg-3+deb9u1_amd64.deb && dpkg -x libqt5network5_5.7.1+dfsg-3+deb9u1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/q/qtbase-opensource-src/libqt5xml5_5.7.1+dfsg-3+deb9u1_amd64.deb && dpkg -x libqt5xml5_5.7.1+dfsg-3+deb9u1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/q/qbittorrent/qbittorrent-nox_3.3.7-3_amd64.deb && dpkg -x qbittorrent-nox_3.3.7-3_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/g/gcc-6/libstdc++6_6.3.0-18+deb9u1_amd64.deb && dpkg -x libstdc++6_6.3.0-18+deb9u1_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/i/icu/libicu57_57.1-6+deb9u2_amd64.deb && dpkg -x libicu57_57.1-6+deb9u2_amd64.deb ~/deb-temp
wget -q http://ftp.nl.debian.org/debian/pool/main/libp/libproxy/libproxy1_0.4.11-4+b2_amd64.deb && dpkg -x libproxy1_0.4.11-4+b2_amd64.deb ~/deb-temp
mv ~/deb-temp/usr/lib/x86_64-linux-gnu/* ~/lib/
mv ~/deb-temp/usr/bin/* ~/bin/
rm -rf ~/*.deb ~/deb-temp

Configuring before starting qBittorrent

We need to do some configuration before we can run qBittorrent for the first time. Make the necessary directory and open a blank config file with the following command:

mkdir -p ~/.config/qBittorrent && nano ~/.config/qBittorrent/qBittorrent.conf

Then, copy and paste the following into the file (use shift + insert to paste):



Once you're done hold ctrl + x to save. Press y to confirm.

Finally, run the following to set things up on a different port, where port is a number between 10001 and 32001:

sed -i "s|Port=8080|Port=port|g" ~/.config/qBittorrent/qBittorrent.conf

Starting, stopping and restarting

This section covers the qBittorrent process - starting it, stopping it and restarting it. It also covers checking if the process is running, in case that becomes necessary.

screen -dmS qBittorrent /bin/bash -c 'export LD_LIBRARY_PATH=~/lib:/usr/lib; ~/bin/qbittorrent-nox'
check running
pgrep -fu "$(whoami)" "SCREEN -dmS qBittorrent"
pkill -fu "$(whoami)" 'SCREEN -dmS qBittorrent'
pkill -fu "$(whoami)" 'SCREEN -dmS qBittorrent'; sleep 3 && screen -dmS qBittorrent /bin/bash -c 'export LD_LIBRARY_PATH=~/lib:/usr/lib; ~/bin/qbittorrent-nox'
kill (force stop)
pkill -9 -fu "$(whoami)" 'SCREEN -dmS qBittorrent'

Automatically restarting qBittorrent if it is not running

Cron jobs can be used to check if qBittorrent is running and start it up if it is not. There is a separate page on configuring cron jobs.

Using qBittorrent

To access qBittorrent, we first need get the URL to access it on. Get this with the following command:

echo "http://$(whoami).$(hostname -f):$(sed -rn 's|WebUI\\Port=||p' ~/.config/qBittorrent/qBittorrent.conf)"

By default the username is admin and the password is adminadmin. You should change these as soon as possible. You can do this by opening the URL above, clicking the preferences icon (the icon on the far right). Then, click the Web UI tab and scroll down to the Authentication section. Make the changes to the username and password you want then scroll down and click Save.


If you experience issues or crashes using qBittorrent the first thing to try and do is restart the software using the command listed in the section above, "Starting, stopping and restarting".


pkill -9 -fu "$(whoami)" 'SCREEN -dmS qBittorrent'
rm -rf ~/.config/qBittorrent/ ~/private/qBittorrent