beelzebub

Summary

A secure low code deception runtime framework, leveraging AI for System Virtualization.

Release history

1. v3.9.0 Aug 5, 2026 · issue 011

   Beelzebub v3.9.0 adds a ServicePlugin interface for boot-time background plugins, migrates plugin declarations to YAML config, and introduces shared JSON Schema validation for honeypot configurations.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v3.9.0 https://github.com/beelzebub-labs/beelzebub.git
   # already have the repo? check out this version:
   $ git checkout v3.9.0

   └──▷ USE IT
   Declare plugins in the new YAML config so make start automatically installs, wires, and compiles them into the binary.
   configurations/plugins.yaml copy

   plugins:
     - source: github.com/your-org/beelzebub-myplugin
     - source: github.com/your-org/[email protected]

   Run a non-interactive local install and build without starting the runtime, then validate all configs before launching — useful in CI.
   copy

   $ ./install.sh --local --no-run && beelzebub validate --conf-core ./configurations/beelzebub.yaml --conf-services ./configurations/services/

   • ›Adds configurations/plugins.yaml as the canonical home for plugin declarations, replacing programmatic registration; plugins listed under the plugins: key are installed and compiled in at build time via make start or make docker.
   • ›Introduces the ServicePlugin interface in pkg/plugin for background plugins that start automatically at runtime boot, alongside the existing CommandPlugin and HTTPPlugin interfaces.
   • ›Adds shared JSON Schema validation for honeypot service configurations, enabling beelzebub validate to enforce a common schema across all service definition files.
   • ›Improves the ./install.sh installer with new flags --local, --docker, and --no-run for non-interactive and headless deployment workflows.