HellPot

Note: This is a community-maintained fork of HellPot to preserve the project and ensure its continued availability, maintenance and support. All credit for the original creation and design goes to yunginnanet. Original repository: yunginnanet/HellPot

Summary

Grave Consequences

HellPot is an endless HTTP honeypot that sends unruly bots straight to hell. It uses a Markov engine to endlessly feed those that ignore robots.txt get an infinite stream of Nietzsche-themed nonsense while looking just real enough to keep them hooked.

Latest release: HellPot 0.6.0-Community
pre-built binaries for Linux, macOS, Windows, FreeBSD

Docker

HellPot includes a modern, secure Dockerfile and docker-compose.yml.

git clone https://github.com/bdk38/HellPot.git

cd HellPot

Create folders + copy default config with correct ownership

sudo install -d -m 0755 -o 65532 -g 65532 config logs

sudo install -m 0644 -o 65532 -g 65532 docker_config.toml ./config/config.toml

Customize (Optional)

sudo nano ./config/config.toml

Start

docker compose up -d

Watch live logs — you'll see the redesigned retro ASCII banner!

docker compose logs -f

Quick Start (Binary)

Download the latest release from HellPot 0.6.0-Community

Generate default config:

./HellPot --genconfig

Customize (Optional)

sudo nano ./config/config.toml

Run:

./HellPot --config config.toml

Building from Source (Requires Go 1.24+)

git clone https://github.com/bdk38/HellPot.git

cd HellPot

make

While these upgrades represent meaningful progress, the fork remains a work in progress and further enhancements are planned. Issues, feature requests, and pull requests are warmly welcomed.