Skip to Content
DocsApplicationsDownload ClientsqBittorrent
qBittorrent

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.

🌐 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:

qb install qbittorrent -u username

CLI Commands

CommandDescription
qb install qbittorrent -u usernameInstall qBittorrent with automatic configuration
qb reinstall qbittorrent -u usernameReinstall while preserving QuickBox integration
qb update qbittorrent -u usernameUpdate qBittorrent and dependencies from compiled packages
qb remove qbittorrent -u usernameRemove qBittorrent and clean up files
qb help qbittorrentDisplay comprehensive help information

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:

  1. In your *arr app, go to Settings → Download Clients → Add (+)
  2. Select qBittorrent from the list
  3. 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
  4. 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
🎬

Media Management

Sonarr ⭐Radarr ⭐LidarrReadarr
🔍

Indexers

Prowlarr ⭐Jackett
⬇️

Other Download Clients

DelugerTorrentTransmission
🎨

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
pyLoadrTorrent