qBittorrent
An advanced and multi-platform BitTorrent client with a nice Qt user interface as well as a Web UI for remote control and an integrated search engine. qBittorrent aims to meet the needs of most users while using as little CPU and memory as possible.
Default File Paths
- Default Downloads Folder:
~/downloads/qbittorrent - Configuration Folder:
~/.config/qbittorrent - Watch Folder:
~/watch/qbittorrent
Add .torrent File
To add a .torrent file to qBittorrent via the Web UI you have two options, either click File in the top menu bar, then click Add torrent file or click the small white page icon. This will open your file explorer for you to add your .torrent file.
Add Magnet Link
Adding a magnet link is the same. However, instead of adding a torrent file, you choose Add torrent link and paste your links in the dialog box. You can paste multiple links at once.
Find IP Address
If your private tracker requests the IP of your torrent client, you can find it with the following instructions. qBittorrent will use a pooled IP for improved performance. You can see which IP is being used by qBittorrent from the Apps tab of your User Control Panel. Find qBittorrent in the list and press the Show Info button to reveal the Assigned IP: xxx.xxx.xxx.xxx
Configuration
Install Dark Theme (Optional)
The below instructions will by script install a dark theme to your qBittorrent instance. Should you rather want to install Theme Park manually, you can follow our guide Theme Park.
- Check out the dark themes at Theme Park.
- Connect to your Ultra service via SSH.
- Run the script via the following SSH command:
bash <(wget -qO- https://scripts.ultra.cc/main/qBittorrent/qBitTheme.sh)- Select one theme out of the four dark themes available from Theme Park.
- Organizr Dark, Dark, Darcula or Overseerr.
- If you get a Webserver error, please restart your webserver from the Overview tab on the UCP.
Enable Public Torrent Seeding (Optional)
- Public torrents are stopped after download by default to avoid HDD IO resource abuse and inadvertent usage of upload traffic. You can easily enable public torrent seeding with the instructions given below.
- Connect to your Ultra service via SSH.
- Execute the following command:
app-qbittorrent restart --remove-pubscript- To enable the script again, execute the following command:
app-qbittorrent restart --add-pubscript- Note that changing the password, repairing or reinstalling the torrent client will disable public torrent seeding again.
Enable Automatic Extraction of RAR archives (Optional)
If a torrent's data is archived within .rar(s) then you can enable the following setting to allow qBittorrent to run a command to automatically extract the data within the torrent's download directory after the torrent download has completed.
- Navigate to your qBittorrent's settings
- Within the Downloads tab, scroll down to find the Run external program on torrent completion text box and enter the following command:
qBittorrent version equal to or lower than 4.3.9
/usr/bin/7z x "%F/*.rar" -o "%F/"qBittorrent version equal to or higher than 4.5.5
/usr/bin/unrar e %F/*.rar -o %F/- Click the Save button to save your changes then wait for your qBittorrent web interface to reload.
Torrent Queue
If you have an Ultra service with HDD instead of NVME, you need to be mindful of your disk neighbors and not hammer the disk with high IO utilization. See this guide for more information on how to check your disk IO utilization.
One way to mitigate this is to limit the amount of active downloads in your torrent client. Below you will find instructions on how to do this for qBittorrent.
- In the qBittorrent webUI, click on cog icon in the top menu bar.
- Click on the
BitTorrentat the top.
- Set Maximum active downloads to
1-3depending on how it affects the disk IO utilization. - Set Total and Seeding to
500
qBittorrent can handle up to 10K torrents before it becomes unstable. If you are approaching that amount, you should limit the Maximum active uploads/torrents to 10000 to avoid unnecessary crashes.
Upgrade qBittorrent
In this section, we will show you how to successfully upgrade your qBittorrent instance from 4.3.9 to 4.5.5, 4.6.3 or 5.0.x. Before proceeding with the upgrade, we recommend taking a backup of your qBittorrent config directory and torrent session state.
- First, stop qBittorrent from the Apps tab on the UCP.
- Connect to your Ultra.cc service via SSH. Once connected, take a backup of your qBittorrent config and torrent session by executing the following command:
cp -r ~/.config/qBittorrent ~/.config/qBittorrent.bak && cp -r ~/.local/share/qBittorrent ~/.local/share/qBittorrent.bak- Next, go back to the UCP and uninstall qBittorrent. Make sure to let at least one minute pass after qBittorrent has been uninstalled.
- Then, while still on the UCP, go to the Installers tab and re-install qBittorrent while choosing version a new version.
- DO NOT click the
Cleanupbutton, as that will wipe your qBittorrent config directory and torrent session state. Even though we have previously backed it up, we want to avoid doing this. - Once the installation has been completed, you can proceed with accessing the qBittorrent Web UI. If successful, your qBittorrent configuration and torrent session state will be preserved.
Restore Backup
If the qBittorrent configuration and torrent session state was not successfully preserved after the upgrade. It can be manually restored from the backup that was made pre-upgrade.
- First, stop qBittorrent from the Apps tab on the UCP.
- Connect to your Ultra.cc service via SSH, and execute the following command:
rm -rf ~/.config/qBittorrent && rm -rf ~/.local/share/qBittorrent && cp -r ~/.config/qBittorrent.bak ~/.config/qBittorrent && cp -r ~/.local/share/qBittorrent.bak ~/.local/share/qBittorrent- Next, restart qBittorrent by executing
app-qbittorrent restart, or go back to the UCP and restart qBittorrent from the Apps tab. - Access your qBittorrent Web UI to confirm the backup restoration was successful.
If you require further assistance, you can open a support ticket here!
Feedback and suggestions regarding this article are welcome on our Discord server