hetty README

The project's README from github.com/dstotijn/hetty. As one markdown file: README.md.

Latest GitHub release Build Status GitHub download count GitHub Documentation

Hetty is an HTTP toolkit for security research. It aims to become an open source alternative to commercial software like Burp Suite Pro, with powerful features tailored to the needs of the infosec and bug bounty community.

Hetty proxy logs (screenshot)

Features

👷‍♂️ Hetty is under active development. Check the backlog for the current status.

📣 Are you pen testing professionally in a team? I would love to hear your thoughts on tooling via this 5 minute survey. Thank you!

Getting started

💡 The Getting started doc has more detailed install and usage instructions.

Installation

The quickest way to install and update Hetty is via a package manager:

macOS

brew install hettysoft/tap/hetty

Linux

sudo snap install hetty

Windows

scoop bucket add hettysoft https://github.com/hettysoft/scoop-bucket.git
scoop install hettysoft/hetty

Other

Alternatively, you can download the latest release from GitHub for your OS and architecture, and move the binary to a directory in your $PATH. If your OS is not available for one of the package managers or not listed in the GitHub releases, you can compile from source (link coming soon).

Docker

Docker images are distributed via GitHub's Container registry and Docker Hub. To run Hetty via with a volume for database and certificate storage, and port 8080 forwarded:

docker run -v $HOME/.hetty:/root/.hetty -p 8080:8080 \
  ghcr.io/dstotijn/hetty:latest

Usage

Once installed, start Hetty via:

hetty

💡 Read the Getting started doc for more details.

To list all available options, run: hetty --help:

$ hetty --help

Usage:
    hetty [flags] [subcommand] [flags]

Runs an HTTP server with (MITM) proxy, GraphQL service, and a web based admin interface.

Options:
    --cert         Path to root CA certificate. Creates file if it doesn't exist. (Default: "~/.hetty/hetty_cert.pem")
    --key          Path to root CA private key. Creates file if it doesn't exist. (Default: "~/.hetty/hetty_key.pem")
    --db           Database file path. Creates file if it doesn't exist. (Default: "~/.hetty/hetty.db")
    --addr         TCP address for HTTP server to listen on, in the form \"host:port\". (Default: ":8080")
    --chrome       Launch Chrome with proxy settings applied and certificate errors ignored. (Default: false)
    --verbose      Enable verbose logging.
    --json         Encode logs as JSON, instead of pretty/human readable output.
    --version, -v  Output version.
    --help, -h     Output this usage text.

Subcommands:
    - cert  Certificate management

Run `hetty <subcommand> --help` for subcommand specific usage instructions.

Visit https://hetty.xyz to learn more about Hetty.

Documentation

📖 Read the docs

Support

Use issues for bug reports and feature requests, and discussions for questions and troubleshooting.

Community

💬 Join the Hetty Discord server

Contributing

Want to contribute? Great! Please check the Contribution Guidelines for details.

Acknowledgements

Sponsors

💖 Are you enjoying Hetty? You can sponsor me!

License

MIT

© 2019–2025 Hetty Software

hetty (dstotijn/hetty)

Searching Database…

12.5K ·GitHub
What is this?Hetty is an HTTP toolkit for security research, aiming to be an open source alternative to commercial tools like Burp Suite Pro, aimed at the infosec and bug bounty community.
Is this a command-line proxy or does it have a UI?It runs an MITM HTTP proxy from the command line plus a web-based admin interface for reviewing traffic, editing requests, and replaying them.
How do I install and run it?Install via a package manager (macOS, Linux, Windows) or download the release binary for your OS/architecture and add it to your PATH, then start it by running 'hetty'. A Docker image is also available via GitHub Container Registry and Docker Hub.
Do I need anything else installed, like Go?No separate runtime is required if you use a package manager, release binary, or Docker image; compiling from source requires Go since the project is written in Go.
Is Hetty feature-complete like Burp Suite Pro?No, it's explicitly under active development and positioned as an aspiring open source alternative, not a finished replacement yet.
Which operating systems does it run on?macOS, Linux, and Windows all have dedicated package manager instructions, plus GitHub release binaries for various OS/architecture combos and a Docker image.
Where does my proxied traffic data get stored?Hetty stores everything locally in a project-based database on your own machine, nothing is sent to a remote service.
What can I do with the proxy besides just logging traffic?You can search logs with advanced filters, manually craft or edit HTTP requests with a built-in client, replay proxied requests, and intercept requests/responses to review, edit, or cancel them before they go through.
What is Scope used for?Scope support lets you restrict which traffic Hetty tracks and shows, helping keep large engagements organized by filtering out irrelevant hosts or paths.
How do I see all the CLI options?Run 'hetty --help' to list all available command-line options.
What are similar projects?ffuf, httpx, evilginx2, ARTEX, dirsearch, ARTEX, ARTEX, bettercap
Creator
dstotijn
Size
1.7 MB
Stars
12.5K
Age
6y
Commits · 90 Days