Skip to content

Setup Linux

Pavel Fedarovich edited this page May 28, 2024 · 31 revisions

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
Clone this wiki locally