---
title: "Homarr Integration — qBittorrent"
aliases: [homarr-qbittorrent, qbittorrent-integration]
tags: [homarr, homelab, torrent, integration, download-client]
sources: [raw/Homarr documentation 9.md]
created: 2026-04-19
updated: 2026-04-19
---

## qBittorrent Integration

qBittorrent is a free and open-source BitTorrent client. In Homarr it acts as a **Download Client** integration — the same category as Deluge, Transmission, and Usenet clients.

## Widgets & Capabilities

| Widget | Function |
|--------|----------|
| [[wiki/homelab/homarr-download-client\|Download Client]] | View and manage active torrent downloads — pause, resume, delete |

The integration slot in Homarr is labeled **Download Client**. Once linked, the [[wiki/homelab/homarr-download-client\|Download Client widget]] can pull live data from qBittorrent.

## Adding the Integration

Follow the standard [[wiki/homelab/homarr-integrations\|Integrations Management]] flow:
1. Navigate to **Settings → Integrations**
2. Click **Add integration** → select **qBittorrent**
3. Enter the base URL of your qBittorrent Web UI
4. Provide credentials (see below)
5. Save and attach to the Download Client widget

## Secrets

| Name | Description |
|------|-------------|
| Username | qBittorrent Web UI account username |
| Password | qBittorrent Web UI account password |

Credentials are stored as integration secrets (not in plain config).

## Key Takeaways

- qBittorrent connects via **username + password** — no API key needed
- It exposes one widget type: **Download Client** (shared with all other torrent/Usenet clients)
- Setup follows the standard [[wiki/homelab/homarr-integrations\|Homarr integrations]] pattern — no extra steps
- The [[wiki/homelab/homarr-download-client\|Download Client widget]] supports multiple clients simultaneously; add qBittorrent alongside Usenet clients if running both

## Sources

- `raw/Homarr documentation 9.md` — qBittorrent integration page (homarr.dev/docs/integrations/q-bittorent/)
