docker.recipes

qBittorrent with VueTorrent

beginner

qBittorrent with modern VueTorrent web interface.

Overview

qBittorrent is an open-source BitTorrent client developed as a lightweight alternative to µTorrent, offering a clean interface without ads or bloatware. Originally created in 2006, qBittorrent has become one of the most popular torrent clients due to its cross-platform compatibility, active development, and comprehensive feature set including sequential downloading, IP filtering, and built-in search engine. The application provides both desktop and web-based interfaces, making it ideal for headless server deployments and remote management scenarios. VueTorrent represents a complete reimagining of qBittorrent's web interface, built using the Vue.js framework to deliver a modern, responsive experience that rivals native desktop applications. This Docker configuration combines qBittorrent's proven torrenting capabilities with VueTorrent's sleek interface through the LinuxServer.io Docker modification system. The integration eliminates the traditional clunky web UI limitations, providing real-time updates, drag-and-drop functionality, and mobile-responsive design while maintaining full access to qBittorrent's advanced features like RSS automation and category management. This stack is perfect for home media server enthusiasts, seedbox operators, and anyone requiring a powerful yet user-friendly torrenting solution that can be accessed from any device. The combination offers enterprise-grade reliability through Docker containerization while delivering a consumer-friendly interface that makes torrent management intuitive for both novice and advanced users.

Key Features

  • VueTorrent modern web interface with real-time torrent status updates and mobile-responsive design
  • Built-in RSS feed monitoring with automatic torrent downloading based on custom filters and rules
  • Advanced category and tagging system for organizing torrents with custom download paths
  • Sequential downloading support for streaming media files while downloading
  • Integrated search engine supporting multiple public and private tracker sites
  • IP filtering and VPN binding capabilities for enhanced privacy and security
  • Bandwidth scheduling with speed limits based on time of day and network conditions
  • Web seed support and DHT/PEX protocol implementation for improved download reliability

Common Use Cases

  • 1Home media server setup for managing large libraries of movies, TV shows, and music collections
  • 2Seedbox deployment on VPS or dedicated servers for high-ratio private tracker maintenance
  • 3Remote torrent management for users who need to add and monitor downloads while away from home
  • 4Educational institutions downloading and sharing open courseware and research datasets
  • 5Content creators distributing large files like video projects or software releases via BitTorrent
  • 6Linux distribution mirroring and open-source software seeding for community support
  • 7Personal cloud storage alternative for backing up and syncing large files across devices

Prerequisites

  • Docker and Docker Compose installed with at least 2GB available RAM for optimal performance
  • Port forwarding configured on router for ports 6881 TCP/UDP to improve connectivity and download speeds
  • Sufficient disk space in download directory with consideration for incomplete torrent storage
  • Basic understanding of torrent protocols and legal implications in your jurisdiction
  • Network configuration knowledge if using VPN or proxy services for privacy
  • Familiarity with qBittorrent settings for RSS feeds and automation if using advanced features

For development & testing. Review security settings, change default credentials, and test thoroughly before production use. See Terms

docker-compose.yml

docker-compose.yml
1services:
2 qbittorrent:
3 image: lscr.io/linuxserver/qbittorrent:latest
4 container_name: qbittorrent
5 environment:
6 - PUID=1000
7 - PGID=1000
8 - TZ=UTC
9 - WEBUI_PORT=8080
10 - DOCKER_MODS=ghcr.io/vuetorrent/vuetorrent-lsio-mod:latest
11 volumes:
12 - qbittorrent-config:/config
13 - /path/to/downloads:/downloads
14 ports:
15 - "8080:8080"
16 - "6881:6881"
17 - "6881:6881/udp"
18 networks:
19 - qbittorrent-network
20 restart: unless-stopped
21
22volumes:
23 qbittorrent-config:
24
25networks:
26 qbittorrent-network:
27 driver: bridge

.env Template

.env
1# qBittorrent
2# Default password printed in logs on first run
3# Change /path/to/downloads to your directory

Usage Notes

  1. 1Web UI at http://localhost:8080
  2. 2Check logs for initial password
  3. 3VueTorrent modern interface
  4. 4Category and tag support
  5. 5RSS auto-download

Quick Start

terminal
1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4 qbittorrent:
5 image: lscr.io/linuxserver/qbittorrent:latest
6 container_name: qbittorrent
7 environment:
8 - PUID=1000
9 - PGID=1000
10 - TZ=UTC
11 - WEBUI_PORT=8080
12 - DOCKER_MODS=ghcr.io/vuetorrent/vuetorrent-lsio-mod:latest
13 volumes:
14 - qbittorrent-config:/config
15 - /path/to/downloads:/downloads
16 ports:
17 - "8080:8080"
18 - "6881:6881"
19 - "6881:6881/udp"
20 networks:
21 - qbittorrent-network
22 restart: unless-stopped
23
24volumes:
25 qbittorrent-config:
26
27networks:
28 qbittorrent-network:
29 driver: bridge
30EOF
31
32# 2. Create the .env file
33cat > .env << 'EOF'
34# qBittorrent
35# Default password printed in logs on first run
36# Change /path/to/downloads to your directory
37EOF
38
39# 3. Start the services
40docker compose up -d
41
42# 4. View logs
43docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

terminal
1curl -fsSL https://docker.recipes/api/recipes/qbittorrent-vuetorrent/run | bash

Troubleshooting

  • VueTorrent interface not loading or showing default theme: Clear browser cache and ensure DOCKER_MODS environment variable is properly set with vuetorrent-lsio-mod
  • Torrents stuck in 'Stalled' status with no peers: Check port forwarding configuration and verify ports 6881 TCP/UDP are accessible from external networks
  • Downloads failing with 'Permission denied' errors: Verify PUID and PGID match your host system user ID and that download directory has correct ownership
  • RSS feeds not automatically downloading torrents: Check RSS filter syntax and ensure download rules are properly configured in Settings > RSS tab
  • Web UI accessible locally but not remotely: Confirm WEBUI_PORT environment variable matches exposed port and firewall allows connections on port 8080
  • High memory usage or container crashes: Increase Docker memory limits and check for corrupted torrent files in the queue that may cause processing issues

Community Notes

Loading...
Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

Includes docker-compose.yml, .env template, README, and license

Ad Space