# QBittorrent

QBittorrent is a free, open-source BitTorrent client that provides a self-hosted web-based interface for downloading, managing, and scheduling torrent files. It is open source and self-hosted, installable on Proxmox, Kubernetes (Helm), ZimaOS, TrueNAS, Umbrel and Unraid.

Canonical page: https://ourlocalhost.com/app/323/qbittorrent

## Description

qBittorrent is a free, open-source BitTorrent client that provides a self-hosted web-based interface for downloading, managing, and scheduling torrent files.

## Platform availability

Available on 6 of 9 platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Proxmox, Helm.

## Health score

86/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 19 days ago)
- Popular: 65 (1,746 GitHub stars)
- Easy to install: 85 (6 install platforms, install notes, Docker image)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=qbittorrent
- Kubernetes (Helm): https://artifacthub.io/packages/helm/gabe565/qbittorrent
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/qBittorrent
- TrueNAS: https://apps.truenas.com/catalog/qbittorrent/
- Umbrel: https://apps.umbrel.com/app/qbittorrent
- Unraid: https://ca.unraid.net/apps/qbittorrent-1xcxc2g1oynnmk?q=qbittorrent
- Official website: https://www.qbittorrent.org/
- GitHub: https://github.com/linuxserver/docker-qbittorrent
- Documentation: https://wiki.qbittorrent.org

## Common questions

### How do I avoid permission problems with the LinuxServer.io qBittorrent container?

Set PUID and PGID to your host user and group IDs before running it. You can find your IDs by running id your_user.

### Which ports do I need to expose for qBittorrent?

Expose the Web UI port, default 8080, for the browser. Also open the torrenting port, default 6881, over TCP and UDP.

### Which folders should I mount to keep qBittorrent data safe?

Mount /config to an appdata folder and /downloads to the location where completed torrents should be saved. /config stores settings and login.

### Can I run qBittorrent through a VPN on a home server?

A qBittorrent container can be routed through a VPN using Gluetun.

### Can I control qBittorrent remotely from a browser?

qBittorrent supports remote control through a Web user interface written with AJAX. It is nearly identical to the regular GUI.

## Alternatives

- BiglyBT: Source for BiglyBT, a feature filled, open source, ad-free, bittorrent client.
- Deluge: Deluge is a lightweight, free-software, cross-platform BitTorrent client for downloading and managing torrent files.
- Free Download Manager: Accelerates downloads by splitting files, supports dark mode, controls traffic, enhances speed, organizes downloads, and is ad-free.
- LibreTorrent: LibreTorrent is a Free as in Freedom torrent client for Android 4 and later, based on libtorrent.
- Motrix: Motrix is a full-featured download manager that supports downloading HTTP, FTP, BitTorrent, Magnet, Baidu Net Disk, etc.
- Tixati: Tixati is a peer-to-peer file sharing program that uses the popular BitTorrent protocol.
- Transmission: Transmission is a BitTorrent client for downloading and sharing files over the BitTorrent protocol.
- aria2: Aria2 is a lightweight, multi-protocol, multi-source, cross-platform command-line download utility that retrieves files over HTTP/HTTPS, FT…
- µTorrent: Desktop client for large-scale torrent downloads, offering simultaneous downloads, bandwidth optimization, and scheduling.

---
Source: Our Local Host (https://ourlocalhost.com/app/323/qbittorrent), the self-hosted and open-source app directory.
