Setup Linux - fedarovich/qbittorrent-cli GitHub Wiki
Installing qBittorrent CLI on Linux
Supported Linux Distributions
The following linux distributions and their derivatives are supported at moment:
| Distro | Minimal version |
|---|---|
| Ubuntu | 16.04 |
| Linux Mint | 18 |
| Debian | 9 |
| RHEL/CentOS/Oracle Linux | 7 |
| Fedora | 33 |
| openSUSE | 15.2 |
| Alpine | 3.12 |
Only x64 (aka x86-64, aka AMD64), ARM and ARM64 platforms are currently supported.
Note that the application might run on other distros and platforms (for example, x86). See the Advanced Setup Guide for more details.
Installation
The installation process is different for the different distributions. Please, find the instructions for your distro below:
Debian
Step 1. Install prerequisites.
sudo apt update
sudo apt install apt-transport-https ca-certificates
Step 2. Download and install the gpg key for the qBittorrent CLI repository.
wget -qO- 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key' | sudo apt-key add -
Step 3. Add qBittorrent CLI repository.
Debian 12.x (bookworm)
wget -q https://repos.fedarovich.com/debian/bookworm/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Debian 11.x (bullseye)
wget -q https://repos.fedarovich.com/debian/bullseye/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Debian 10.x (buster)
wget -q https://repos.fedarovich.com/debian/buster/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Debian 9.x (stretch)
wget -q https://repos.fedarovich.com/debian/stretch/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Step 4. Install qBittorrent CLI
sudo apt update
sudo apt install qbittorrent-cli
Ubuntu, Mint
Step 1. Download and install the gpg key for the qBittorrent CLI repository.
wget -qO- 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key' | sudo apt-key add -
Step 2. Add qBittorrent CLI repository.
Ubuntu 24.04 (noble)
wget -q https://repos.fedarovich.com/ubuntu/noble/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 23.10 (mantic)
wget -q https://repos.fedarovich.com/ubuntu/mantic/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 23.04 (lunar)
wget -q https://repos.fedarovich.com/ubuntu/lunar/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 22.10 (kinetic)
wget -q https://repos.fedarovich.com/ubuntu/kinetic/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 22.04 (jammy), Mint 21.x
wget -q https://repos.fedarovich.com/ubuntu/jammy/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 21.10 (impish)
wget -q https://repos.fedarovich.com/ubuntu/impish/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 21.04 (hirsute)
wget -q https://repos.fedarovich.com/ubuntu/hirsute/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 20.10 (groovy)
wget -q https://repos.fedarovich.com/ubuntu/groovy/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 20.04 (focal), Mint 20.x
wget -q https://repos.fedarovich.com/ubuntu/focal/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 18.04 (bionic), Mint 19.x
wget -q https://repos.fedarovich.com/ubuntu/bionic/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Ubuntu 16.04 (xenial), Mint 18.x
wget -q https://repos.fedarovich.com/ubuntu/xenial/qbittorrent-cli.list
sudo mv qbittorrent-cli.list /etc/apt/sources.list.d/
Step 3. Install qBittorrent CLI
sudo apt update
sudo apt install qbittorrent-cli
openSUSE
Step 1. Add qBittorrent CLI repository.
openSUSE Tumbleweed
sudo zypper ar -cf -r https://repos.fedarovich.com/opensuse/tw/qbittorrent-cli.repo
sudo zypper --gpg-auto-import-keys refresh qbittorrent-cli-qbittorrent-cli qbittorrent -cli-qbittorrent-cli-source
openSUSE Leap 15
sudo zypper ar -cf -r https://repos.fedarovich.com/opensuse/15/qbittorrent-cli.repo
sudo zypper --gpg-auto-import-keys refresh qbittorrent-cli-qbittorrent-cli qbittorrent -cli-qbittorrent-cli-source
Step 2. Install qBittorrent CLI
sudo zypper install qbittorrent-cli
Fedora
Step 1. Add qBittorrent CLI repository.
Fedora 37
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
sudo dnf config-manager --add-repo https://repos.fedarovich.com/fedora/37/qbittorrent-cli.repo
Fedora 36
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
sudo dnf config-manager --add-repo https://repos.fedarovich.com/fedora/36/qbittorrent-cli.repo
Fedora 35
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
sudo dnf config-manager --add-repo https://repos.fedarovich.com/fedora/35/qbittorrent-cli.repo
Fedora 34
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
sudo dnf config-manager --add-repo https://repos.fedarovich.com/fedora/34/qbittorrent-cli.repo
Fedora 33
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
sudo dnf config-manager --add-repo https://repos.fedarovich.com/fedora/33/qbittorrent-cli.repo
Step 2. Install qBittorrent CLI
sudo dnf install qbittorrent-cli
RHEL/CentOS/Oracle Linux
Step 1. Add qBittorrent CLI repository.
RHEL 9.x/Oracle Linux 9.x
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
curl https://repos.fedarovich.com/centos/8/qbittorrent-cli.repo -o qbittorrent-cli.repo
sudo mv qbittorrent-cli.repo /etc/yum.repos.d/
RHEL 8.x/CentOS 8/Oracle Linux 8.x
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
curl https://repos.fedarovich.com/centos/8/qbittorrent-cli.repo -o qbittorrent-cli.repo
sudo mv qbittorrent-cli.repo /etc/yum.repos.d/
RHEL 7.x/CentOS 7/Oracle Linux 7.x
sudo rpm --import 'https://dl.cloudsmith.io/public/qbittorrent-cli/qbittorrent-cli/gpg.F8756541ADDA2B7D.key'
curl https://repos.fedarovich.com/centos/7/qbittorrent-cli.repo -o qbittorrent-cli.repo
sudo mv qbittorrent-cli.repo /etc/yum.repos.d/
Step 2. Install qBittorrent CLI
sudo yum install qbittorrent-cli
Alpine
At the moment no APK packages are provided for Alpine, so the installation must be done manually.
Step 1. Use su to get the root permissions
Run su to get the root permissions:
su
Step 2. Install the prerequisites
apk add icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib
Step 3. Download the Archive
Open https://github.com/fedarovich/qbittorrent-cli/releases/latest, find the archive named qbt-linux-alpine-architecture-version.tar.gz where architecture is your CPU architecture (x64/arm/arm64) and copy its URL.
Download the archive to your home directory (replace URL_YOU_COPIED with the actual URL):
wget URL_YOU_COPIED
Step 4. Unpack the archive and create symbolic link
Replace ARCHIVE_NAME with the actual name of the archive you have downloaded:
mkdir /usr/lib/qbittorrent-cli
tar -zxf ARCHIVE_NAME -C /usr/lib/qbittorrent-cli
chmod a+x /usr/lib/qbittorrent-cli/qbt
ln -sf /usr/lib/qbittorrent-cli/qbt /usr/bin/qbt
Step 5. Exit the root session
exit