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):
[LegalNotice] Accepted=true [Preferences] General\Locale=en_GB WebUI\Port=8080 Downloads\SavePath=private/qBittorrent/data
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.
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