qBittorrent

Feature-rich BitTorrent client with Web UI and integrated search

qBittorrent is a free, open-source BitTorrent client with a clean Qt interface and powerful Web UI for remote administration. QuickBox Pro deploys qBittorrent as the headless qbittorrent-nox binary from QuickBox compiled packages, built with Qt6, libtorrent-rasterbar 2.x, and Boost 1.83+ for maximum performance and compatibility. The installed version is resolved dynamically from the compiled-packages manifest for your distro, so you always get the latest available build.

🌐 Web UI

Full-featured web interface via nginx reverse proxy with user-scoped paths

🔍 Integrated Search

Built-in search engine with plugin support for finding torrents

⚡ Qt6 + libtorrent 2.x

Modern stack compiled with latest Qt6 and libtorrent-rasterbar

📁 RSS Manager

Automated downloads via RSS feeds with smart filters

🔐 PBKDF2 Authentication

Secure password hashing using libqbpasswd for Web UI access

📊 Advanced Queueing

Smart torrent queueing with upload/download limits and scheduling

QuickBox Integration Only

qBittorrent should always be managed via the QuickBox CLI (qb) and dashboard. Avoid manual distro package upgrades or editing systemd/nginx files directly.

Installation

Symptoms

QuickBox Pro v3 installed and configured
User account created on the server
Sufficient disk space for torrent data and session files

Resolution

Use QuickBox's qb command for installation
Automatic configuration with reverse proxy
Per-user installation with isolated credentials

Basic Installation

Install qBittorrent for a specific user. The version, along with all dependencies (libtorrent-rasterbar, Boost, Qt6), is resolved automatically from the compiled-packages manifest for your distro:


qb install qbittorrent -u username

CLI Commands

Command	Description
`qb install qbittorrent -u username`	Install qBittorrent (latest available version)
`qb reinstall qbittorrent -u username`	Reinstall while preserving QuickBox integration
`qb update qbittorrent -u username`	Update qBittorrent and all dependencies from compiled packages
`qb remove qbittorrent -u username`	Remove qBittorrent and clean up files
`qb help qbittorrent`	Display comprehensive help information

Dynamic Version Resolution

qBittorrent versions are resolved dynamically from the packages.lst manifest in the QuickBox/compiled-packages repository. The CLI automatically determines the latest available build for your distro codename, along with the matching libtorrent-rasterbar, Boost, and Qt6 dependencies. No manual database updates or version flags are needed.

Branch Channels

QuickBox Pro uses two package channels: main (stable, default) and develop (beta, opt-in). The channel is detected automatically based on your installation. Beta servers may receive newer qBittorrent builds before they are promoted to stable.

CLI Options

-u, --usernameRequired

Target QuickBox username for install/reinstall/remove operations. Supply Admin username for version updates affecting all users.

Automatic Port Assignment

QuickBox automatically assigns the Web UI port starting at 11001 (auto-incremented per user). Find your assigned port in the QuickBox dashboard or in ~/.config/qBittorrent/qBittorrent.conf.

Accessing qBittorrent

After installation, access qBittorrent at:


https://your-server-ip/qbittorrent/

QuickBox Dashboard Integration

qBittorrent is automatically integrated into your QuickBox dashboard. Find it in the Service Control panel with port and status information. Click the LAUNCH icon to open the web interface.

Login credentials:

Username: Your QuickBox username
Password: Your QuickBox password (hashed with PBKDF2)

Initial Configuration

1. Configure Download Paths

Settings → Downloads → Default Save Path: /home/username/torrents/qbittorrent/downloads
Completed torrents can be moved to a different folder automatically
Watch folder configured at /home/username/torrents/qbittorrent/watch

2. Connect to `*arr` Applications (Optional)

If using Sonarr, Radarr, or other *arr applications:

In your *arr app, go to Settings → Download Clients → Add (+)
Select qBittorrent from the list
Enter connection details:
- Host: 127.0.0.1
- Port: Your Web UI port (check ~/.config/qBittorrent/qBittorrent.conf)
- Username: Your QuickBox username
- Password: Your QuickBox password
- Category: Create categories like sonarr, radarr as needed
Test and save

3. Enable Search Plugins (Optional)

Tools → Search → Search plugins → Check for updates
Install plugins for your preferred torrent sites
Search functionality accessible via Web UI

Service Management

qBittorrent runs as a systemd service for reliability and automatic startup.


systemctl status qbittorrent@username     # Check status
systemctl restart qbittorrent@username    # Restart service
journalctl -u qbittorrent@username -f     # View live logs
systemctl enable qbittorrent@username     # Start on boot
systemctl disable qbittorrent@username    # Prevent auto-start

Troubleshooting

qBittorrent Won’t Start


journalctl -u qbittorrent@username -f

Check for port conflicts:


grep -i 'WebUI\\Port' ~/.config/qBittorrent/qBittorrent.conf
# Default: 11001

Web UI Not Accessible

Symptoms

Cannot access qBittorrent web interface
404 or connection refused errors
Nginx proxy not working

Resolution

Verify service is running: systemctl status qbittorrent@username
Check nginx configuration: /etc/nginx/conf.d/username.qbittorrent.conf
Ensure port is correct in qBittorrent.conf
Reload nginx: systemctl reload nginx

Permission Issues


qb fix permissions -u username
systemctl restart qbittorrent@username

Configuration Reset


# Backup current configuration
cp ~/.config/qBittorrent/qBittorrent.conf ~/.config/qBittorrent/qBittorrent.conf.backup
 
# Remove configuration (will be regenerated)
rm ~/.config/qBittorrent/qBittorrent.conf
 
# Restart service
systemctl restart qbittorrent@username

Best Practices

Do

Use qb update qbittorrent to keep qBittorrent and dependencies updated
Monitor service health with systemctl status qbittorrent@username
Configure RSS feeds and smart filters for automated downloads
Create separate categories for different `*arr` applications
Enable sequential download for media files you want to preview
Use the built-in search engine with updated plugins
Set upload/download limits to manage bandwidth effectively
Configure watch folders for automatic torrent loading

Don't

Don't install qBittorrent from system package managers—use QuickBox packages only
Don't manually edit systemd or nginx configs without backing up first
Don't expose the Web UI directly to the internet without nginx in front
Don't use the same category for multiple `*arr` applications
Don't ignore disk space warnings—qBittorrent may stop downloading
Don't disable DHT/PEX if you use public trackers
Don't set global upload limits too low—may hurt ratio on private trackers
Don't manually edit qBittorrent.conf while the service is running

Use Cases

Automated Media Downloads

Connect to Sonarr, Radarr, Lidarr for automated TV, movie, and music downloads
Category-based organization with automatic file management
Integration with modern *arr stack for complete automation

Manual Torrent Management

Full-featured web interface for adding and managing torrents manually
RSS feed automation for recurring downloads
Search engine integration for finding content directly

Private Tracker Seeding

Advanced ratio management with per-torrent upload limits
Sequential downloading for faster availability
Detailed statistics and tracking for private tracker requirements

FAQ

The CLI resolves the latest available version from the packages.lst manifest in the QuickBox/compiled-packages repository. The manifest is cached locally with a 1-hour TTL and filtered by your distro codename. The matching libtorrent-rasterbar, Boost, and Qt6 dependencies are also resolved automatically.

Currently, the qBittorrent install script always resolves and installs the latest available version from the manifest for your distro. There is no -o version flag for qBittorrent. If you need to stay on a specific version, avoid running qb update qbittorrent.

The main channel (default) contains stable, tested builds. The develop channel (beta) may include newer qBittorrent versions not yet promoted to stable. Your server's channel is detected automatically.

QuickBox compiles qBittorrent with custom builds of libtorrent-rasterbar 2.x, Boost 1.83+, Qt6, and optionally GCC 12+ (on systems with older compilers). All are resolved and installed as precompiled packages from the manifest.

🎬

Media Management

Sonarr ⭐Radarr ⭐Lidarr Readarr

🔍

Indexers

Prowlarr ⭐Jackett

⬇️

Other Download Clients

Deluge rTorrent Transmission

🎨

Web Interfaces

Flood

Additional Resources

qBittorrent Official Documentation

Official wiki with configuration guides and API documentation

qBittorrent Web API

WebUI API reference for automation and integration

qBittorrent GitHub Repository

Official source code and issue tracking

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support

Feature Previews

Community Configs

Active Discussions

Join Discord Server

qBittorrent

🌐 Web UI

🔍 Integrated Search

⚡ Qt6 + libtorrent 2.x

📁 RSS Manager

🔐 PBKDF2 Authentication

📊 Advanced Queueing

Installation

Symptoms

Resolution

Basic Installation

CLI Commands

Dynamic Version Resolution

CLI Options

Accessing qBittorrent

Initial Configuration

1. Configure Download Paths

2. Connect to *arr Applications (Optional)

3. Enable Search Plugins (Optional)

Service Management

Troubleshooting

qBittorrent Won’t Start

Web UI Not Accessible

Symptoms

Resolution

Permission Issues

Configuration Reset

Best Practices

Do

Don't

Use Cases

Automated Media Downloads

Manual Torrent Management

Private Tracker Seeding

FAQ

Related Applications

Media Management

Indexers

Other Download Clients

Web Interfaces

Additional Resources

Join the Community

2. Connect to `*arr` Applications (Optional)