Setup Advanced Packages - fedarovich/qbittorrent-cli GitHub Wiki

qBittorrent CLI packages

qBittorrent CLI is a cross-platform application created using .Net Core 2.1/3.1, thus it can run on any platform .Net Core, .Net Framework or Mono supports.

There are three kinds of packages: installer packages, platform-specific packages and platform-agnostic packages.

Installer packages

Installer package are the standard installer packages used on the corresponding platforms:

  • MSI on Windows
  • DEB on Debian, Ubuntu, Mint and other Debian-based Linux distributions
  • RPM on Fedora, CentOS, openSUSE
  • PKG on macOS

Using installer packages is the recommended way to install stable versions of qBittorrent CLI on the supported platforms.

Platform-specific packages

Platform-specific packages are plain zip or tar.gz archives containing binaries compiled to be used on the certain platforms without the need to install .Net Core runtime.

Using platform-specific packages is the recommended way to install prerelease versions of qBittorrent CLI or to install several version side by side.

The following platform-specific packages are provided at the moment:

Package OS x86 x64 ARM
qbt-win-x86-version.zip Windows 7 SP1 or later
qbt-win-x64-version.zip Windows 7 SP1 or later
qbt-linux-x64-version.tar.gz Linux
qbt-linux-arm-version.tar.gz Linux
qbt-osx-x64-version.tar.gz macOS 10.13 or later

Platform-specific packages must be manually unpacked and installed. Click the links in the table above to get the detailed installation instructions for the corresponding platform.

Platform-agnostic packages

Platform-specific packages are plain zip or tar.gz archives containing binaries compiled to be used on any platform where .Net Core, .Net Framework or Mono runtime is available.

Platform-agnostic packages are much more lightweight themselves but required .Net runtime to be installed. You may want to use platform-agnostic packages on the platforms not supported by installer packages and platform-specific packages.

Package Required Runtime
qbt-netcore21-version.zip .Net Core 2.1 or later
qbt-netcore21-version.tar.gz .Net Core 2.1 or later
qbt-netcore31-version.zip .Net Core 3.1 or later
qbt-netcore31-version.tar.gz .Net Core 3.1 or later
qbt-netfx46-version.zip On Windows: .Net Framework 4.6 or later (included in Windows 10, available as a separate download for Windows 7 SP1 or later.)
On Linux & Mac OS X: mono 5.4 or later

Platform-specific packages must be manually unpacked and installed. Follow the link to get the detailed installation instructions.

Choosing between installer, platform-specific and platform-agnostic packages

Most users should use installer packages to install qBittorrent CLI as they provide easy to use and manage experience for the supported platforms.

You may consider using platform-specific packages in the following cases:

  • You want to use prerelease version of qBittorrent CLI.
  • You want to have several versions of qBittorrent CLI side by side.
  • You want to install qBittorrent CLI only for the current user without administrative permissions.

In most cases you should prefer platform-specific packages over platform-agnostic ones. Even though they are larger than platform-agnostic packages, they don't depend on the installed runtime environment and thus more stable and easier to maintain.

You should consider installing platform-agnostic packages if your operating system or CPU architecture is not supported by a platform-specific package. For example, you have an x86 version of Ubuntu 12.04. There is no platform-specific package for this platform but you can still download qbt-netfx46-version.zip package and run it using mono.

See Also

⚠️ **GitHub.com Fallback** ⚠️