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 legacy (2.x/3.x) and modern (4.x+, Qt6-based) builds from the compiled-packages manifest, with per-user systemd services, nginx reverse proxy, and pre-configured RPC access.

Installation

Basic Installation (Legacy)

Install Transmission for a specific user. Without --v4, version 3.00 is installed:

qb install transmission -u username

Modern Installation (4.x+)

Install the latest Transmission 4.x+ build with Qt6 support. The exact version is resolved dynamically from the compiled-packages manifest for your distro:

qb install transmission -u username --v4

CLI Commands

Dual Packaging Model

Transmission uses different packaging depending on the version series:

• Legacy 2.x/3.x — installed as separate subpackages: transmission-daemon, transmission-cli, transmission-common, transmission-gtk, and transmission-qt. All are held at the installed version to prevent accidental upgrades.
• Modern 4.x+ — installed as a single +allmods .deb that bundles all components. Qt6 dependencies are resolved and installed from the compiled-packages manifest alongside the main package.

This means --v4 does not just change the version number; it changes the entire packaging structure.

Accessing Transmission

After installation, access Transmission at:

https://your-server-ip/transmission/

Login credentials:

• Username: Your QuickBox username
• Password: Your QuickBox password (RPC authentication)

Browser Download Index

In addition to the Transmission Web UI, QuickBox installs a per-user browser file index that lists the contents of your Transmission download directory in a dark-themed fancyindex view. Useful for quickly grabbing a single finished file without loading the torrent client.

https://your-server-ip/username.transmission.downloads

• The listing path matches the Transmission download root, including the downloads/ and watch/ subfolders.
• The index is stitched together per user: if you also have Deluge, qBittorrent, or rTorrent installed, their .downloads locations are appended into the same username.dlindex.conf so each client gets its own URL.
• The feature has no service of its own — it is pure nginx. If the URL returns a 404, verify nginx reloaded after install (systemctl reload nginx) and that /etc/nginx/software/username.dlindex.conf exists.

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.1 for 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:

1. Navigate to Preferences (gear icon) → Network
2. Verify watch directory is enabled: /home/username/torrents/transmission/watch
3. Drop .torrent files into the watch folder—they’ll be added automatically

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 Transmission from the list
3. 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
4. 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-start

Troubleshooting

Transmission Won’t Start

journalctl -u transmission@username -f

Check for port conflicts:

grep -i 'rpc-port' ~/.config/Transmission/settings.json
# Default: 15105

Web Interface Not Accessible

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@username

Permission Issues

qb fix permissions -u username
systemctl restart transmission@username

Version Switch Issues

# If switching from v3 to v4 fails, clean reinstall
qb remove transmission -u username
qb install transmission -u username --v4

Best Practices

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

FAQ

Related Applications

Additional Resources