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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/beelzebub-labsbeelzebub.svg)](https://yunodb.com/tools/beelzebub-labsbeelzebub?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/beelzebub-labsbeelzebub?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/beelzebub-labsbeelzebub.svg" alt="Featured on YunoDB" height="20"></a>