Skip to content

feat: add qBittorrent BitTorrent client template with proper port configuration for BitTorrent functionality.#333

Merged
Siumauricio merged 4 commits intoDokploy:mainfrom
shishirahm3d:add-qbittorrent
Sep 27, 2025
Merged

feat: add qBittorrent BitTorrent client template with proper port configuration for BitTorrent functionality.#333
Siumauricio merged 4 commits intoDokploy:mainfrom
shishirahm3d:add-qbittorrent

Conversation

@shishirahm3d
Copy link
Contributor

@shishirahm3d shishirahm3d commented Sep 4, 2025

📝 Description

Adds a new qBittorrent template to the Dokploy templates repository. qBittorrent is a popular open-source BitTorrent client with a web interface for remote management.

✨ What's Added

  • Docker Compose Configuration: Uses LinuxServer.io's qBittorrent image
  • Traefik Integration: Full HTTPS routing with Let's Encrypt SSL certificates
  • Network Configuration: Proper dokploy-network integration
  • Port Management: Configured BitTorrent ports (6881 TCP/UDP) and web UI (8080)
  • Persistent Storage: Volumes for configuration and downloads
  • Template Configuration: Complete template.toml with domain settings
  • Branding: qBittorrent logo and proper meta.json entry

🔧 Features

  • ✅ Web-based remote management interface
  • ✅ HTTPS access via custom domain
  • ✅ Automatic SSL certificate generation
  • ✅ Persistent configuration and download storage
  • ✅ Proper BitTorrent port exposure for connectivity
  • ✅ Linux permissions handling (PUID/PGID)

📋 Files Changed

  • blueprints/qbittorrent/docker-compose.yml - Main service configuration
  • blueprints/qbittorrent/template.toml - Dokploy template configuration
  • blueprints/qbittorrent/logo.svg - Template logo
  • meta.json - Added template metadata entry

🧪 Testing

  • Docker Compose syntax validated
  • Template.toml structure follows Dokploy standards
  • Meta.json entry properly formatted and positioned
  • All required files present

📚 Related Links

🏷️ Tags

torrent, download, file-sharing

…late with Traefik integration, SSL support, and proper port configuration for BitTorrent functionality.
@github-actions
Copy link

github-actions bot commented Sep 4, 2025

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
templates ✅ Ready (View Log) Visit Preview b0b7cad

@shishirahm3d shishirahm3d changed the title feat: add qBittorrent BitTorrent client template Add qBittorrent template with Traefik integration, SSL support, and proper port configuration for BitTorrent functionality. feat: add qBittorrent BitTorrent client template with Traefik integration, SSL support, and proper port configuration for BitTorrent functionality. Sep 4, 2025
Add qBittorrent BitTorrent client template with Traefik integration, SSL support, and comprehensive setup documentation including default login credentials and first-time configuration instructions.
@Siumauricio
Copy link
Contributor

Please follow our suggestions when submitting a template https://github.com/Dokploy/templates?tab=readme-ov-file#general-suggestions-when-creating-a-template

Update qBittorrent template to follow official guidelines:
- Remove dokploy-network references
- Fix port mapping format
- Ensure service name consistency

Resolves maintainer feedback on template standards.
@shishirahm3d
Copy link
Contributor Author

Please follow our suggestions when submitting a template https://github.com/Dokploy/templates?tab=readme-ov-file#general-suggestions-when-creating-a-template

@Siumauricio template fixed.

Comment on lines +25 to +34
labels:
- "traefik.enable=true"

# Router (HTTPS)
- "traefik.http.routers.qbit.rule=Host(`${QBIT_DOMAIN}`)"
- "traefik.http.routers.qbit.entrypoints=websecure"
- "traefik.http.routers.qbit.tls.certresolver=letsencrypt"

# Service (send traffic to container port 8080)
- "traefik.http.services.qbit.loadbalancer.server.port=8080"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why we need this?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Siumauricio Fixed! ✅
You're right - Dokploy handles the SSL, domain routing, and port configuration automatically through the template.toml file.
Removed the manual Traefik configuration labels. Now it only has:

labels:
  - "traefik.enable=true"

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Siumauricio please review the latest commit.

@shishirahm3d shishirahm3d changed the title feat: add qBittorrent BitTorrent client template with Traefik integration, SSL support, and proper port configuration for BitTorrent functionality. feat: add qBittorrent BitTorrent client template with proper port configuration for BitTorrent functionality. Sep 14, 2025
@Harikrishnan1367709
Copy link
Contributor

Approved
Screenshot 2025-09-23 at 5 17 57 PM

@Siumauricio Siumauricio merged commit e5e0a7d into Dokploy:main Sep 27, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants