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).

Table of contents


Copy and paste the following commands to install qBittorrent:

mkdir -p ~/bin
wget https://bitbucket.org/feralio/wiki/raw/5a89f060aea207f6c51e53481ca4c1847733503c/src/wiki/software/qbittorrent/qbittorrent-nox
mv qbittorrent-nox ~/bin/
 chmod +x ~/bin/qbittorrent-nox

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/qbittorrent-nox
check running
pgrep -fu "$(whoami)" "qbittorrent-nox"
pkill -fu "$(whoami)" 'qbittorrent-nox'
pkill -fu "$(whoami)" '/qbittorrent-nox'; sleep 3 && screen -dmS qBittorrent ~/bin/qbittorrent-nox
kill (force stop)
pkill -9 -fu "$(whoami)" 'qbittorrent-nox'

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)" 'bin/qbittorrent-nox'
rm -rf ~/bin/qbittorrent-nox ~/.config/qBittorrent/ ~/private/qBittorrent