Skip to Content
DocsApplicationsDownload ClientspyLoad
pyLoad

pyLoad

Lightweight Python download manager with web interface

pyLoad is a free, open-source download manager written in Python, designed to be extremely lightweight and easily extensible. It supports downloading from one-click hosters, container formats (DLC, CCF, RSDF), and video sites through its plugin system—all fully manageable via a modern web interface.

🐍 Python-Based

Runs in an isolated Python 3.9 virtual environment for stability

🌐 Web Interface

Modern PyPlex theme with full download management via browser

🔌 Plugin System

Extensible architecture supporting 100+ hosting sites

🔐 SSL Support

Auto-generated SSL certificates for secure connections

Default Password

After installation, the default password is pyload. The username is automatically set to your QuickBox username. Change your password immediately via the web interface settings.

Installation

Symptoms

  • QuickBox Pro v3 installed and configured
  • Valid user account created with qb adduser
  • Python 3.9 available (installed automatically)

Resolution

  • Install QuickBox Pro using the official installer
  • Create user accounts before installing pyLoad
  • QuickBox handles Python virtual environment setup
qb install pyload -u username
CommandDescription
qb install pyload -u usernameInstall pyLoad for the specified user
qb reinstall pyload -u usernameReinstall while preserving configuration
qb remove pyload -u usernameRemove pyLoad and clean up files
qb update pyload -u usernameUpdate pyLoad to the latest version

CLI Options

-u, --usernameRequired

Target QuickBox username for install/remove/update operations

Directory Layout

/opt/username/pyLoad
.venv/# Python 3.9 virtual environment
.venv/bin/pyload# pyLoad executable
/home/username/.config/pyLoad
user/settings/pyload.cfg# Main configuration file
user/data/pyload.db# User database (accounts, settings)
user/data/ssl.key# SSL private key (symlink)
user/data/ssl.crt# SSL certificate (symlink)
downloads/# Default download directory
tmp/# Temporary files during download

Network & Access

pyLoad runs on an auto-assigned port (default 8001) and is accessible through the nginx reverse proxy:

https://yourserver.com/username/pyload/

Default credentials:

  • Username: Your QuickBox username
  • Password: pyload (change immediately after first login)

Security Notice

The default password is pyload for all installations. Change it immediately via Settings → User Manager in the web interface.

Services

pyLoad uses a templated systemd unit (pyload@.service) running as a forking daemon:

# Check status
systemctl status pyload@username
 
# View logs
journalctl -u pyload@username -f
 
# Restart service
systemctl restart pyload@username

Best Practices

Do

  • Change the default password immediately after installation.
  • Use the PyPlex theme (default) for the best user experience.
  • Configure account credentials for premium hosting sites in Settings.
  • Use qb update pyload to keep pyLoad updated.

Don't

  • Do not leave the default password unchanged.
  • Do not manually edit systemd or nginx files—use qb commands.
  • Do not modify files in the virtual environment directly.

Additional Resources

Resources

pyLoad GitHub Repository
pyLoad Documentation

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
NZBGetqBittorrent