Skip to Content
DocsApplicationsDownload ClientsDeluge
Deluge

Deluge

Lightweight BitTorrent client with daemon + web UI, optimized for QuickBox Pro

Deluge is a lightweight, cross-platform BitTorrent client with a powerful daemon (deluged) and web interface (deluge-web). QuickBox Pro installs Deluge from QuickBox compiled packages with a tuned libtorrent/Boost stack, secure nginx reverse proxy, and per-user configuration handled automatically.

🔧 Headless Daemon

Per-user systemd units for 24/7 torrenting with security hardening

🌐 Web Interface

nginx reverse proxy with user-scoped paths and authentication

💾 Optimized Stack

Deluge, libtorrent (1.2.x/2.x), and Boost 1.83+ from compiled packages

🔗 Automation Ready

FlexGet integration via deluge-client module for advanced automation

🔌 Plugin System

ltConfig and YaRSS2 plugins included for libtorrent tuning and RSS feeds

📊 Smart Queueing

Auto-managed torrents with configurable active download/upload limits

QuickBox Integration Only

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

Installation

Prerequisites

  • QuickBox Pro v3 is already installed
  • You have a user account on the server
  • You planned disk space for torrents and session data

What you get

  • Install via QuickBox qb command (per-user)
  • Reverse proxy and paths are templated automatically
  • Each user gets isolated credentials and services

Basic Installation

Install Deluge for a specific user:

qb install deluge -u username

CLI Commands

QuickBox CLI Commands

Command
qb install deluge -u username
Description
Install Deluge from compiled packages with nginx proxy, per-user systemd units, and templated configs.
Scope
Per-user
Command
qb reinstall deluge -u username
Description
Reinstall while keeping QuickBox integration and regenerating configs if needed.
Scope
Per-user
Command
qb update deluge -u username
Description
Admin-only update for Deluge, libtorrent, and Boost compiled packages (applies to all users).
Scope
Admin
Command
qb remove deluge -u username
Description
Remove Deluge for the user and clean up QuickBox-managed files.
Scope
Removal
Command
qb help deluge
Description
Show full help, flags, and examples for Deluge on QuickBox.
Scope
Reference

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

  • Daemon port: Random from 59000–65535
  • Web UI port: Random from 10001–11000

Find your assigned ports in the QuickBox dashboard or in ~/.config/Deluge/core.conf.

Accessing Deluge

After installation, access Deluge at:

https://your-server-ip/username/deluge/

QuickBox Dashboard Integration

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

  • Password: Your QuickBox password (authenticates to daemon via hostlist.conf)

Initial Configuration

1. Connect Web UI to Daemon

On first launch, the web UI will prompt you to connect to a daemon:

  1. Click Add if no daemon is listed
  2. Use these credentials (automatically configured):
    • Hostname: 127.0.0.1
    • Port: Your daemon port (see ~/.config/Deluge/hostlist.conf)
    • Username: Your QuickBox username
    • Password: Your QuickBox password
  3. Click Add then Connect

2. Configure Paths and Preferences

Default Paths (created by QuickBox templates)
/home/username
torrents/
└── deluge/# Per-user Deluge data root
│ ├── download/# Active + completed downloads
│ │ ├── incomplete/# Active downloads (temporary until completion)
│ │ └── complete/# Completed downloads moved here automatically
│ ├── .sessions/# Session state and resume data
│ └── watch/# Auto-import folders
│ │ ├── start/# Auto-start torrents dropped here
│ │ └── load/# Staging/queue folder for manual imports

Adjust via Preferences → Downloads if needed.

3. 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 Deluge from the list
  3. Enter connection details (enable advanced settings to access URL Base):
    • Host: 127.0.0.1 or localhost
    • Port: 443
    • Use SSL: Enabled
    • URL Base: /username/deluge
    • Password: Your QuickBox password
    • Category: Create categories like sonarr, radarr as needed
  4. Test and save

Service Management

Deluge uses templated systemd units (deluged@.service, deluge-web@.service) for isolation and security hardening.

# Check status
systemctl status deluged@username
systemctl status deluge-web@username
 
# Restart services
systemctl restart deluged@username
systemctl restart deluge-web@username
 
# View logs
journalctl -u deluged@username -f
journalctl -u deluge-web@username -f
 
# Enable/disable auto-start
systemctl enable deluged@username deluge-web@username
systemctl disable deluged@username deluge-web@username

Troubleshooting

Deluge Won’t Start

journalctl -u deluged@username -f
journalctl -u deluge-web@username -f

Check for port conflicts:

grep -E 'listen_ports|daemon_port' ~/.config/Deluge/core.conf
grep -E 'port' ~/.config/Deluge/web.conf

Web UI Cannot Connect to Daemon

Symptoms

  • Web UI shows 'No connection to daemon' error
  • Connection refused when trying to connect
  • Authentication failures

Resolution

  • Verify daemon is running: systemctl status deluged@username
  • Check hostlist.conf for correct credentials and port
  • Ensure daemon and web UI are both running
  • Restart both services: systemctl restart deluged@username deluge-web@username

Permission Issues

qb fix permissions -u username
systemctl restart deluged@username deluge-web@username

Configuration Reset

# Backup current configuration
cp -r ~/.config/Deluge ~/.config/Deluge.backup
 
# Stop services
systemctl stop deluge-web@username deluged@username
 
# Remove configuration (will be regenerated)
rm -rf ~/.config/Deluge/*
 
# Reinstall to regenerate configs
qb reinstall deluge -u username

Best Practices

Do

  • Use qb update deluge to keep Deluge, libtorrent, and Boost in sync
  • Use the ltConfig plugin for libtorrent tuning and performance optimization
  • Monitor health with systemctl status and journalctl
  • Configure YaRSS2 plugin for RSS feed automation
  • Set appropriate upload/download limits for your connection
  • Use categories to organize torrents by type or source
  • Enable move on complete for automatic file organization
  • Keep daemon and web UI running for remote access

Don't

  • Don't upgrade Deluge/libtorrent via the OS package manager
  • Don't edit global templates in /opt/quickbox/config/software/deluge
  • Don't expose Deluge Web directly without nginx authentication
  • Don't manually edit config files while services are running
  • Don't ignore config permission errors—they prevent saving settings
  • Don't mix distro packages with QuickBox compiled packages
  • Don't disable encryption if you use public trackers
  • Don't forget to backup configs before major updates

Use Cases

Automated Media Downloads

  • Connect to Sonarr, Radarr, Lidarr for automated downloads
  • Category-based organization with automatic file management
  • FlexGet integration for advanced RSS and automation workflows

Lightweight Headless Torrenting

  • Minimal resource usage compared to other clients
  • Daemon runs independently of web UI
  • Perfect for remote servers with limited resources

Advanced Plugin Ecosystem

  • ltConfig plugin for fine-tuning libtorrent performance
  • YaRSS2 for RSS feed automation with filters
  • Custom plugins for specialized workflows
🎬

Media Management

Sonarr ⭐Radarr ⭐LidarrReadarr
🔍

Indexers

Prowlarr ⭐Jackett
🛠️

Automation

FlexGet
⬇️

Other Download Clients

qBittorrentrTorrentTransmission

Additional Resources

Deluge Official Website

Official Deluge homepage with downloads and announcements

Deluge Documentation

User guide and configuration documentation

Deluge GitHub Repository

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
Download ClientsFlood