Skip to content

bdk38/HellPot

 
 

Repository files navigation

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

HellPot

Go Version Go Report Card GoDoc License: MIT

hellpotv060

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.

About

HellPot is a cross-platform portal to endless suffering meant to punish unruly HTTP bots.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Go 99.5%
  • Other 0.5%