PeerBanHelper
PeerBanHelper is a self-hosted security tool that protects BitTorrent clients from unwanted peers.
Platform availability
Available on 1 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
81/100 Excellent
- Maintained
- 100last commit 5 days ago
- Popular
- 766,400 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 94no serious findings, 1 minor, CI, tests
Based on 4 of 5 factors.
- GitHub stars
- 6,400
- Open issues
- 16
- Last commit
- 2026-11-16
- Latest release
- v9.5.5
- License
- GPL-3.0
- Activity
- steady
Checked 4 days ago - source: GitHub (PBH-BTN/PeerBanHelper)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Use Docker Compose, open port 9898, keep data safe Save the Docker Compose file (the script that starts the app in a container) and run it, then make sure port 9898 is open because that’s where you reach the web interface; also match PUID/PGID (the container’s user/group IDs) to your host user so it can read and write the data folder. source
- Set the server token in config.yml In config.yml under server, set the token to a secret you remember because it acts like the password for the Web UI/API; if you lose it, you may be locked out of managing bans. source
- Manual Linux: install Java 21 and use nogui If you’re installing without Docker, install OpenJDK 21 (Java) first, then start the JAR with the nogui option on a machine with no desktop. Without Java the app can’t start, and without nogui it may try to open a graphical window that isn’t available. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com, github.com, pbh-docs.ghostchu.com, tieba.baidu.com
Community
Collected 48 days ago - public community threads