CanaBRR qBittorrent, libtorrent, Swizzin, and Linux tuning notes

Installing qBittorrent 5.1.4 with Swizzin

June 12, 2026

Use this guide when Swizzin is already installed and you want to add a fresh qBittorrent 5.1.4 Web UI through Swizzin. This is for a new qBittorrent install, not an upgrade from an older qBittorrent version.

If qBittorrent is already installed on the server, use the upgrade guide instead: Upgrade qBittorrent 4.6.7 to 5.1.4 with Swizzin.

Requirements

  • A working Swizzin server with nginx and the panel already installed.
  • Root or sudo access over SSH.
  • A Swizzin user account that will own the qBittorrent service.
  • A trusted certificate is recommended before exposing the panel for regular use.

Backup First

If the server is a VM or VPS with snapshot support, take a snapshot before installing qBittorrent. If the server is bare metal, read the install prompts carefully before continuing and make sure you have a recovery path for the system and user data.

Install Commands

Install qBittorrent through Swizzin so the package, service, nginx route, and Web UI integration are managed together.

Run this from a normal interactive SSH terminal. Swizzin uses a terminal menu for the version picker; if your shell has TERM=dumb or cannot draw menus, the installer can exit before you can select a version. Open a regular SSH session and rerun the command.

sudo box install qbittorrent

When Swizzin shows the qBittorrent version menu, select 5.1 (5.1.4). Do not continue with an older branch if this guide is being used to install qBittorrent 5.1.4 specifically.

After selecting 5.1.4, the build can be quiet for several minutes while Swizzin compiles Boost, libtorrent, and qBittorrent. Let it finish unless the installer prints a clear error.

Do not install a separate qBittorrent package over the Swizzin-managed service.

Verify The Service

After the installer finishes, Swizzin prints a line like Enabling qbittorrent for <username> or Started qbt for <username>. Use that exact username in the service commands below.

sudo systemctl status qbittorrent@<username>
sudo systemctl is-active qbittorrent@<username>
qbittorrent-nox --version
dpkg -l | grep -Ei 'qbittorrent|libtorrent'
  • The service check should show the qBittorrent user service running.
  • The active check should return active.
  • The version check should report qBittorrent 5.1.4.
  • The package list should show the qBittorrent and libtorrent packages installed by the Swizzin path.

Open The Web UI

Open the qBittorrent Web UI through the Swizzin nginx route in your browser.

https://<server-hostname-or-ip>/qbittorrent/

If prompted by the web server, log in with the Swizzin username and password. qBittorrent may then show its own login prompt; on a standard Swizzin install, use the same credentials again.

The default qBittorrent download location is usually ~/torrents/qbittorrent. Confirm the path in the qBittorrent Web UI before adding torrents.

Rollback

If the install fails on a VM or VPS, restoring the snapshot is the cleanest rollback. Without a snapshot, remove qBittorrent through Swizzin instead of deleting service files by hand.

sudo box remove qbittorrent

Next Step

Once qBittorrent 5.1.4 is installed, the WebUI loads, and the service survives a restart, keep the default settings until basic downloads and uploads are confirmed. Then continue with qBittorrent 5.1.4 performance tuning with libtorrent 1.2 and Swizzin.