Please make yourself aware of the Ultra.cc Fair Usage Policy. Directly pointing any cloud storage directory using Rclone will create extreme strain on your slot's disk and WILL cause a 24-hour ban on accessing your cloud storage repeatedly. It is YOUR responsibility to ensure usage is within acceptable limits. Ignorance is not an excuse.

If you are on an HDD plan, you should be mindful not to have multiple simultaneous downloads active as it will cause high disk IO utilization, and negatively affect your disk neighbors. There is no set limit on how many active downloads you can have, though depending on the download speeds, we recommend 1-3 at the most. To monitor the disk IO utilization, see this link.

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

Add .torrent file


Install Dark Theme (Optional)

Dark Theme is not official, please keep this in mind if you encounter any artifacts or misplaced elements in your Web UI

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

bash <(wget -qO- https://scripts.usbx.me/main/qBittorrent/qBitTheme.sh)

If you get a Webserver error, please restart your webserver from the Overview tab on the UCP.

Enable Public Torrent Seeding (Optional)

app-qbittorrent restart --remove-pubscript

Note that changing the password of the torrent client or re-installing it 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.

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/

Note that setting this automatic extraction program command on completion will only apply to torrents finished after the command is saved. Finished torrents with the .rar archives that completed before setting this automatic extraction method will still need to be extracted manually.

Torrent Queueing

If you have an Ultra.cc 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.

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 4.3.9 to 4.5.5

Please note, downgrading of qBittorrent can be a bit buggy, and it should be avoided.

In this section, we will show you how to successfully upgrade your qBittorrent instance from 4.3.9 to 4.5.5. Before proceeding with the upgrade, we recommend taking a backup of your qBittorrent config directory and torrent session state.

cp -r ~/.config/qBittorrent ~/.config/qBittorrent.bak && cp -r ~/.local/share/qBittorrent ~/.local/share/qBittorrent.bak

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.

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

Revision #32
Created 15 November 2021 20:39:01 by Joe
Updated 22 March 2024 21:00:57 by varg