Skip to main content

Initial setup

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

Qbit's config folder: ~/.config/qbittorrent

Qbit's watch folder ~/watch/qbittorrent

Add .torrent file

To add a .torrent file to Qbitorrent via the Web Ui, you have two options either click file then Add torrent file or click the small white page icon. This will open your file explorer for you to add your .torrent file

Install Dark Theme (Optional)

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

  1. Check out the dark themes at Theme Park.
  2. Login to your slot via SSH. How to connect to your slot via SSH
  3. Run the script via the following SSH command:
bash <(wget -qO-
  1. Choose one theme out of the four dark themes available from theme park. [Organizr Dark, Dark, Darcula & Overseerr].

If you get a Webserver error, please restart your slot's webserver from the Control Panel's Slot info tab.

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.
  • Login to your service via SSH. How to connect to your slot via SSH
  • Execute the following SSH command:
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.

  • 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:
/usr/bin/7z x "%F/*.rar" -o"%F/"
  • Click the Save button to save your changes then wait for your qBittorrent web interface to reload.

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.