# PeerBanHelper

PeerBanHelper is a self-hosted security tool that protects BitTorrent clients from unwanted peers. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5124/peerbanhelper

## Description

PeerBanHelper is a self-hosted security tool that protects BitTorrent clients from unwanted peers. It connects to your torrent client through its Web API, monitors incoming connections, and automatically bans leechers and unruly or suspicious peers, with support for custom rules. It keeps your bandwidth focused on fast, healthy, and fair sharing.

## Platform availability

Available on 1 of 10 platforms: Mac.

## Desktop and other devices

Mac.

## Health score

81/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 5 days ago)
- Popular: 76 (6,400 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Official website: https://docs.pbh-btn.com/en/
- GitHub: https://github.com/PBH-BTN/PeerBanHelper
- Docker Hub: https://hub.docker.com/r/ghostchu/peerbanhelper
- desktop: https://github.com/PBH-BTN/PeerBanHelper/releases/latest
- Documentation: https://docs.pbh-btn.com/

## Common questions

### Which Docker network mode should I use for PeerBanHelper?

Host network mode is recommended since v9.0.0. In bridge mode, 127.0.0.1 or localhost inside the container points to the container itself, not the host machine.

### How do I access or recover the PeerBanHelper web interface?

Set the server token in config.yml under the server section. It acts as the password for the Web UI/API, and losing it can lock you out of managing bans.

### Can PeerBanHelper run on a headless Linux server?

Yes. Install OpenJDK 21 first, then start the JAR with the nogui option. Without Java it will not start, and without nogui it may try to open a graphical window.

### Do users report false bans from PeerBanHelper?

A community thread asks whether it false-bans normal users and whether the ban rate is high. One user reported that upload speed was zero most of the time after using it.

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