From e5e0a7d7307ecb1604133a3f0857842a23e995ea Mon Sep 17 00:00:00 2001
From: Shishir Ahmed <51795191+shishirahm3d@users.noreply.github.com>
Date: Sun, 28 Sep 2025 03:10:48 +0600
Subject: [PATCH] feat: add qBittorrent BitTorrent client template with proper
 port configuration for BitTorrent functionality. (#333)

* feat: add qBittorrent BitTorrent client template  Add qBittorrent template with Traefik integration, SSL support,  and proper port configuration for BitTorrent functionality.

* feat: add qBittorrent template

Add qBittorrent BitTorrent client template with Traefik integration, SSL support, and comprehensive setup documentation including default login credentials and first-time configuration instructions.

* fix: apply Dokploy template best practices

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.

* fix: remove manual Traefik config, use Dokploy auto-SSL
---
 blueprints/qbittorrent/docker-compose.yml | 29 +++++++++++++++++++++++
 blueprints/qbittorrent/qbittorrent.svg    | 16 +++++++++++++
 blueprints/qbittorrent/template.toml      | 11 +++++++++
 meta.json                                 | 17 +++++++++++++
 4 files changed, 73 insertions(+)
 create mode 100644 blueprints/qbittorrent/docker-compose.yml
 create mode 100644 blueprints/qbittorrent/qbittorrent.svg
 create mode 100644 blueprints/qbittorrent/template.toml

diff --git a/blueprints/qbittorrent/docker-compose.yml b/blueprints/qbittorrent/docker-compose.yml
new file mode 100644
index 00000000..38e2fdec
--- /dev/null
+++ b/blueprints/qbittorrent/docker-compose.yml
@@ -0,0 +1,29 @@
+# docker-compose.yml
+# 
+# IMPORTANT: First-time setup information
+# - Default username: admin
+# - Password: Check container logs for temporary password on first startup
+# - Access via your configured domain (HTTPS) after deployment
+# - Change the default password immediately after first login
+#
+services:
+  qbittorrent:
+    image: lscr.io/linuxserver/qbittorrent:latest
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - WEBUI_PORT=8080
+      - TORRENTING_PORT=6881
+    volumes:
+      - qb_config:/config
+      - qb_downloads:/downloads
+    ports:
+      - 8080
+      - 6881:6881
+      - 6881:6881/udp
+    labels:
+      - "traefik.enable=true"
+volumes:
+  qb_config:
+  qb_downloads:
diff --git a/blueprints/qbittorrent/qbittorrent.svg b/blueprints/qbittorrent/qbittorrent.svg
new file mode 100644
index 00000000..69d8cf62
--- /dev/null
+++ b/blueprints/qbittorrent/qbittorrent.svg
@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <title>
+    qbittorrent-new-light
+  </title>
+  <defs>
+    <linearGradient x1="34.012%" y1="0%" x2="76.373%" y2="76.805%" id="a">
+      <stop stop-color="#72B4F5" offset="0%"/>
+      <stop stop-color="#356EBF" offset="100%"/>
+    </linearGradient>
+  </defs>
+  <g fill="none" fill-rule="evenodd">
+    <circle stroke="#DAEFFF" stroke-width="32" fill="url(#a)" cx="512" cy="512" r="496"/>
+    <path d="M712.898 332.399q66.657 0 103.38 45.671 37.03 45.364 37.03 128.684t-37.34 129.61q-37.03 45.98-103.07 45.98-33.02 0-60.484-12.035-27.156-12.344-45.672-37.649h-3.703l-10.8 43.512h-36.724V196h51.227v116.65q0 39.191-2.469 70.359h2.47q35.796-50.61 106.155-50.61zm-7.406 42.894q-52.46 0-75.605 30.242-23.145 29.934-23.145 101.219t23.762 102.145q23.761 30.55 76.222 30.55 47.215 0 70.36-34.254 23.144-34.562 23.144-99.058 0-66.04-23.144-98.442-23.145-32.402-71.594-32.402z" fill="#fff"/>
+    <path d="M317.273 639.45q51.227 0 74.68-27.466 23.453-27.464 24.996-92.578v-11.418q0-70.976-24.07-102.144-24.07-31.168-76.223-31.168-45.055 0-69.125 35.18-23.762 34.87-23.762 98.75 0 63.879 23.454 97.515 23.761 33.328 70.05 33.328zm-7.715 42.894q-65.421 0-102.144-45.98-36.723-45.981-36.723-128.376 0-83.011 37.032-129.609 37.03-46.598 103.07-46.598 69.433 0 106.773 52.461h2.778l7.406-46.289h40.426V828h-51.227V683.27q0-30.86 3.395-52.461h-4.012q-35.488 51.535-106.774 51.535z" fill="#c8e8ff"/>
+  </g>
+</svg>
\ No newline at end of file
diff --git a/blueprints/qbittorrent/template.toml b/blueprints/qbittorrent/template.toml
new file mode 100644
index 00000000..96c38812
--- /dev/null
+++ b/blueprints/qbittorrent/template.toml
@@ -0,0 +1,11 @@
+[variables]
+main_domain = "${domain}"
+
+[config]
+env = []
+mounts = []
+
+[[config.domains]]
+serviceName = "qbittorrent"
+port = 8080
+host = "${main_domain}"
diff --git a/meta.json b/meta.json
index 0af46940..9dab7f27 100644
--- a/meta.json
+++ b/meta.json
@@ -4243,6 +4243,23 @@
       "management"
     ]
   },
+  {
+    "id": "qbittorrent",
+    "name": "qBittorrent",
+    "version": "latest",
+    "description": "A free and open-source BitTorrent client with web interface for remote management. Default login: admin (check container logs for temporary password on first startup).",
+    "logo": "qbittorrent.svg",
+    "links": {
+      "github": "https://github.com/qbittorrent/qBittorrent",
+      "website": "https://www.qbittorrent.org/",
+      "docs": "https://github.com/qbittorrent/qBittorrent/wiki"
+    },
+    "tags": [
+      "torrent",
+      "download",
+      "file-sharing"
+    ]
+  },
   {
     "id": "qdrant",
     "name": "Qdrant",