Transmission
Lightweight BitTorrent client that “just works”
Transmission is a fast, easy-to-use BitTorrent client designed with sensible defaults that work out of the box. Ubuntu chose Transmission as its default BitTorrent client largely due to its easy learning curve. QuickBox Pro offers Transmission in both v3 (3.00, stable from system packages) and v4 (Qt6-based from QuickBox compiled packages) with per-user systemd services, nginx reverse proxy, and pre-configured RPC access.
⚡ Just Works
Sensible defaults with minimal configuration needed out of the box
🌐 Web Interface
Clean, responsive web UI via nginx reverse proxy with RPC authentication
📁 Watch Directories
Auto-add torrents from watch folder for automated workflows
🔄 Version Choice
Choose v3 (stable, 3.00) or v4 (Qt6, latest features)
🔐 RPC Whitelist
Secure RPC access with authentication and IP whitelist (127.0.0.1)
🚫 Peer Blocklists
Support for bad peer blocklists to enhance privacy and security
Version Selection
By default, Transmission v3 (3.00) is installed. Use the --v4 flag to install Transmission v4 with Qt6 support and the latest features. Note: Updating between v3 and v4 will replace the installation for all users.
Installation
Symptoms
- QuickBox Pro v3 installed and configured
- User account created on the server
- Sufficient disk space for torrent data
Resolution
- Use QuickBox's qb command for installation
- Automatic configuration with reverse proxy
- Per-user installation with isolated settings
Basic Installation
Install Transmission for a specific user (defaults to v3):
qb install transmission -u usernameVersion-Specific Installation
Install Transmission v4 with Qt6 support:
qb install transmission -u username --v4CLI Commands
| Command | Description |
|---|---|
qb install transmission -u username | Install Transmission v3 (stable, 3.00) |
qb install transmission -u username --v4 | Install Transmission v4 (Qt6, latest) |
qb reinstall transmission -u username | Reinstall while preserving QuickBox integration |
qb update transmission -u username | Update Transmission to latest stable version |
qb update transmission -u username --v4 | Update/switch to Transmission v4 |
qb remove transmission -u username | Remove Transmission and clean up files |
qb help transmission | Display comprehensive help information |
Version Switching
Switching between v3 and v4 (via update or reinstall with --v4) will replace the Transmission installation for all users on the server. Plan accordingly if you have multiple users.
CLI Options
-u, --usernameRequiredTarget QuickBox username for install/reinstall/remove operations. Supply Admin username for version updates affecting all users.
--v4Install or update to Transmission v4 (Qt6-based). Targets all users.
Automatic Port Assignment
QuickBox automatically assigns ports:
- RPC port: Starting at
15105(auto-incremented per user) - Peer port: Random from
49152-65535
Find your assigned RPC port in the QuickBox dashboard or in ~/.config/Transmission/settings.json.
Accessing Transmission
After installation, access Transmission at:
https://your-server-ip/transmission/QuickBox Dashboard Integration
Transmission 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 (RPC authentication)
Initial Configuration
1. Web Interface Setup
On first access, the web interface is pre-configured:
- RPC authentication: Enabled with your QuickBox credentials
- RPC whitelist: Restricted to
127.0.0.1for security - Download directory:
/home/username/torrents/transmission/downloads - Watch directory:
/home/username/torrents/transmission/watch
No additional setup required—Transmission is ready to use immediately.
2. Configure Watch Directory (Optional)
Enable automated torrent loading:
- Navigate to Preferences (gear icon) → Network
- Verify watch directory is enabled:
/home/username/torrents/transmission/watch - Drop
.torrentfiles into the watch folder—they’ll be added automatically
3. Connect to *arr Applications (Optional)
If using Sonarr, Radarr, or other *arr applications:
- In your *arr app, go to Settings → Download Clients → Add (+)
- Select Transmission from the list
- Enter connection details:
- Host:
127.0.0.1 - Port: Your RPC port (check
~/.config/Transmission/settings.json→rpc-port) - URL Path:
/transmission/ - Username: Your QuickBox username
- Password: Your QuickBox password
- Host:
- Test and save
Service Management
Transmission runs as a systemd service for reliability and automatic startup.
systemctl status transmission@username # Check status
systemctl restart transmission@username # Restart service
journalctl -u transmission@username -f # View live logs
systemctl enable transmission@username # Start on boot
systemctl disable transmission@username # Prevent auto-startTroubleshooting
Transmission Won’t Start
journalctl -u transmission@username -fCheck for port conflicts:
grep -i 'rpc-port' ~/.config/Transmission/settings.json
# Default: 15105Web Interface Not Accessible
Symptoms
- Cannot access Transmission web interface
- 403 Forbidden or authentication errors
- RPC connection refused from *arr apps
- nginx proxy not working
Resolution
- Verify service is running: systemctl status transmission@username
- Check RPC whitelist in settings.json includes 127.0.0.1
- Ensure nginx configuration exists: /etc/nginx/conf.d/username.transmission.conf
- Reload nginx: systemctl reload nginx
Configuration File Corruption
# Stop service
systemctl stop transmission@username
# Backup current configuration
cp ~/.config/Transmission/settings.json ~/.config/Transmission/settings.json.backup
# Edit or regenerate configuration
nano ~/.config/Transmission/settings.json
# Restart service
systemctl start transmission@usernamePermission Issues
qb fix permissions -u username
systemctl restart transmission@usernameVersion Switch Issues
# If switching from v3 to v4 fails, clean reinstall
qb remove transmission -u username
qb install transmission -u username --v4Best Practices
Do
- Use qb update transmission to keep Transmission updated safely
- Monitor service health with systemctl status transmission@username
- Use the watch folder for automated torrent loading
- Configure speed limits during peak hours if needed
- Set appropriate peer limits based on your connection
- Enable blocklists for enhanced privacy and security
- Create categories for different *arr applications
- Regularly check disk space—torrents can grow quickly
Don't
- Don't install Transmission from system package managers—use QuickBox only
- Don't manually edit systemd or nginx configs without backing up first
- Don't expose the RPC port directly to the internet without nginx in front
- Don't edit settings.json while service is running—stop it first
- Don't mix v3 and v4 installations—choose one for all users
- Don't delete .config/Transmission directory manually—use qb remove
- Don't ignore RPC whitelist—keep it restricted to 127.0.0.1
- Don't use Transmission for high-performance seeding—consider rTorrent instead
Use Cases
Simple BitTorrent Downloads
- Minimalist approach with sensible defaults that “just work”
- No complex configuration needed—start downloading immediately
- Perfect for users who want simplicity over advanced features
Automated Media Downloads
- Connect to Sonarr, Radarr, Lidarr for automated TV, movie, and music downloads
- Watch directory support for RSS-based automation
- Lightweight resource usage compared to other clients
Beginner-Friendly Client
- Ubuntu’s default BitTorrent client for a reason—easy learning curve
- Clean web interface with intuitive controls
- Ideal for users new to BitTorrent or seedbox management
Related Applications
Indexers
Other Download Clients
Web Interfaces
Additional Resources
Join the Community
Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.