Skip to main content

qBittorrent

qBittorrent is an open-source alternative utorrent. It's written in C++ and uses Boost, Qt toolkit, and the libtorrent library to deliver a fast torrent client.

Intital Setup

box install qbittorrent

This will install a tuned qBittorrent client from HostingByDesign.

How to Access

Accessing the web-gui is simple, just append /qbittorrent to the hostname you've been provisioned on. For instance, https://<hostname.io>/qbittorrent/.

Service Management

Like all box configured applications, you can manage qBittorrent via SSH with box with start, stop, restart, enable and disable commands.

box start qbittorrent

Connecting to other Software:

Connecting to qbittorrent from a service not hosted on the service.

caution

If you've changed the password from the one we have provided then please make sure to use a secure password, the below option will open up your client to the internet without our safety measurements.

Open up the web-gui, as listed above. Click the settings gear icon located in the top left menu. Click Web UI, change the bind IP address to a * (For all IPs), then copy the webui port.

You can now connect to your qBittorrent instance through http://<hostname.io>:<qbittorrent-port> with normal qbittorrent authenication measures rather than nginx-forwarded plain http authenticaiton.

Command Line

caution

These tools are not officially supported. Please consider reaching out to our Discord for unofficial community-driven support on tools listed below.

Some of our community members have written CLI interfaces for qBittorrent. We've included them below, along with install methods for each.

qBittorrent CLI

qBittorrent CLI is a very powerful CLI written in go. You can read about it's features in the command reference. Essentially, it can

  • Add torrents to qBittorrent from file or magnet link. Useful in combination with autodl-irssi
  • Reannounce torrents for troublesome trackers
  • Set limits on how many simultaneously active downloads are allowed
  • Import torrents with state from Deluge and rTorrent
Installation
curl $(curl -sNL https://api.github.com/repos/ludviglundgren/qbittorrent-cli/releases/latest | grep -Po 'ht(.*)linux_amd64(.*)tar.gz') -L -o /tmp/qbittorrent-cli.tar.gz
tar -xvf /tmp/qbittorrent-cli.tar.gz --exclude={CHANGELOG.md,README.md} -C ~/bin/

qbittools

qbittools is a feature rich CLI for the management of torrents. Detailed examples of how to use the tools are in the Readme. Some features are:

  • Adding
  • Unpausing torrents
  • Automatic Tagging of all torrents
  • Exporting torrents.
Installation
curl -Ls https://gitlab.com/AlexKM/qbittools/-/raw/master/install.sh | bash -s -- -o ~/bin/qbittools

Troubleshooting

tip

qBittorrent can be troubleshooted by checking the logs. If you need help connecting to the server, please read the help article here. You can view the log by SSHing into your server and running the following:

less -r +G ~/.local/share/qBittorrent/logs/qbittorrent.log

To exit less, press q.

Transdroid/Transdrone

Should you wish to connect your qBittorrent instance to the mobile application Transdrone, use the following settings:

Name: qBittorrent (or whatever you like)
Server type: qBit
IP or host name: <the hostname of your server>
Username: <your username>
Password: <your password>
Advanced Settings:
Port: 443
Folder: /qbittorrent
Use SSL: ON