qBittorrent with VueTorrent
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:latest4 container_name: qbittorrent5 environment: 6 - PUID=10007 - PGID=10008 - TZ=UTC9 - WEBUI_PORT=808010 - DOCKER_MODS=ghcr.io/vuetorrent/vuetorrent-lsio-mod:latest11 volumes: 12 - qbittorrent-config:/config13 - /path/to/downloads:/downloads14 ports: 15 - "8080:8080"16 - "6881:6881"17 - "6881:6881/udp"18 networks: 19 - qbittorrent-network20 restart: unless-stopped2122volumes: 23 qbittorrent-config: 2425networks: 26 qbittorrent-network: 27 driver: bridge.env Template
.env
1# qBittorrent2# Default password printed in logs on first run3# Change /path/to/downloads to your directoryUsage Notes
- 1Web UI at http://localhost:8080
- 2Check logs for initial password
- 3VueTorrent modern interface
- 4Category and tag support
- 5RSS auto-download
Quick Start
terminal
1# 1. Create the compose file2cat > docker-compose.yml << 'EOF'3services:4 qbittorrent:5 image: lscr.io/linuxserver/qbittorrent:latest6 container_name: qbittorrent7 environment:8 - PUID=10009 - PGID=100010 - TZ=UTC11 - WEBUI_PORT=808012 - DOCKER_MODS=ghcr.io/vuetorrent/vuetorrent-lsio-mod:latest13 volumes:14 - qbittorrent-config:/config15 - /path/to/downloads:/downloads16 ports:17 - "8080:8080"18 - "6881:6881"19 - "6881:6881/udp"20 networks:21 - qbittorrent-network22 restart: unless-stopped2324volumes:25 qbittorrent-config:2627networks:28 qbittorrent-network:29 driver: bridge30EOF3132# 2. Create the .env file33cat > .env << 'EOF'34# qBittorrent35# Default password printed in logs on first run36# Change /path/to/downloads to your directory37EOF3839# 3. Start the services40docker compose up -d4142# 4. View logs43docker compose logs -fOne-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 | bashTroubleshooting
- 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
Components
qbittorrent
Tags
#torrent#qbittorrent#vuetorrent#download#modern
Category
Media & EntertainmentAd Space
Shortcuts: C CopyF FavoriteD Download