beelzebub
A secure low code deception runtime framework, leveraging AI for System Virtualization.
What is beelzebub?
A secure low code deception runtime framework, leveraging AI for System Virtualization.
Overview of beelzebub
What it is
Beelzebub is an open-source deception framework. It allows security teams to deploy realistic decoy services, observe attacker behavior, and capture interactions as security evidence. The framework can run independently or connect to the Beelzebub Platform.
Key features
- Define services, routes, and response rules in YAML. Use static handlers for predictable behavior or LLM-powered responses for adaptive interactions. Extend the runtime with trusted Go plugins.
- Capture evidence from decoy interactions, including commands, HTTP request details, and session context, depending on the protocol.
- Inspect logs locally, publish structured events to RabbitMQ, or enable Beelzebub Platform reporting. Enable Prometheus metrics with
core.prometheus.enabled: true. - Supports SSH, HTTP, TCP, TELNET, and MCP protocols. MCP decoys expose bait tools that make suspicious invocations observable during controlled agent testing.
- Deployment options include a local Go binary, Docker Compose, and Kubernetes with Helm.
Use cases
Deploy decoys that fit your environment. Observe what happens after contact with a decoy service. Bring evidence into your security workflow for investigation.
Getting started
bashgit clone https://github.com/beelzebub-labs/beelzebub.gitcd beelzebub./install.sh --dockerTest the default HTTP decoy and inspect its logs:bashcurl -i http://localhost:8080/docker compose logs -f beelzebubStop the lab when finished:bashdocker compose down
License and pricing
Licensed under the GNU General Public License v3.0. It is open source and free to use.
Based on the project's public README and repository metadata.