# Self-Host-qBittorrent

**Repository Path**: qinly/Self-Host-qBittorrent

## Basic Information

- **Project Name**: Self-Host-qBittorrent
- **Description**: No description available
- **Primary Language**: Docker
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-03
- **Last Updated**: 2025-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Getting Started

Specify download path

```bash
qbittorrent_download_path="/path/to/dir" # change
docker volume create --opt type=none --opt o=bind --opt device=${qbittorrent_download_path} qbittorrent-download 
```

Create config path

```bash
mkdir ./data/qbittorrent/config -p
```

Create `.env` and custom environment variables

```bash
cp .env.example .env
vim .env
```

Boot up Qbittorrent

```bash
docker-compose up -d
```

Update tracker

```bash
docker-compose exec qbittorrent /tasks/add_trackers_update.sh
```

> Click & Save `Options > BitTorrent > Automatically add these trackers to new downloads` in WebUI

## Usage

Task

```bash
# Update subscribed trackers from net
# env: qbt_tracker_fetch_urls —— the updated list of public trackers
# env: qbt_tracker_static_urls —— the public trackers that we have known
docker compose exec qbittorrent /tasks/add_trackers_update.sh

# Ban peers by matching pattern
# env: qbt_peer_ban_pattern
docker compose exec qbittorrent /tasks/ban_peers_add.sh

# Clean up ban list of peers
docker compose exec qbittorrent /tasks/ban_peers_clean.sh

# Update torrent trackers: remove unwork and add newly fetched trackers 
# env: qbt_trackers_update_torrent_num —— the number of torrents to update trackers
docker compose exec qbittorrent /tasks/torrent_trackers_update.sh
```

Config

```bash
+ ./env                       —— tasks (and docker) environment
+ ./tasks/config/crontabs/abc —— tasks schedule
```

Logs

```bash
+ docker compose logs -f -t --tail=100
+ ./data/qbittorrent/config/qBittorrent/logs/qbittorrent.log —— qbittorrent application runtime log
```

## Reference

### Docker

+ Docker - <https://hub.docker.com/r/linuxserver/qbittorrent>
+ Dockerfile - <https://github.com/linuxserver/docker-qbittorrent/blob/master/Dockerfile>
+ linuxserver/mods:universal-cron - <https://github.com/linuxserver/docker-mods/tree/universal-cron>

### Qbittorrent

+ Options Explanation - <https://github.com/qbittorrent/qBittorrent/wiki/Explanation-of-Options-in-qBittorrent>
+ QBittorrent Settings - <https://www.rapidseedbox.com/blog/qbittorrent-settings>