# Quickstart

The Beelzebub Framework provides a simple yaml interface to configure a honeypot. This example configure a simple SSH honeypot. 

```yaml
apiVersion: "v1"
protocol: "ssh"
address: ":22"
description: "SSH simple honeypot"
commands:
  - regex: "^ls$"
    handler: "Documents Images  Desktop Downloads .m2 .kube .ssh  .docker"
  - regex: "^pwd$"
    handler: "/home/"
  - regex: "^uname -m$"
    handler: "x86_64"
   - regex: "^docker .*$"
    handler: "Error response from daemon: dial unix docker.raw.sock: connect: connection refused"
  - regex: "^uname$"
    handler: "Linux"
  - regex: "^(.+)$"
    handler: "command not found"
serverVersion: "OpenSSH"
serverName: "ubuntu"
passwordRegex: "^(root|qwerty|Smoker666|123456|jenkins|minecraft|sinus|alex|postgres|Ly123456)$"
deadlineTimeoutSeconds: 60
```

### Run Beelzebub

We provide two quick start options for run Beelzebub: using Go compiler or docker container.

### Go compiler

```bash
git clone https://github.com/mariocandela/beelzebub.git
go mod download
go build
./beelzebub
```

### Docker compose

```bash
git clone https://github.com/mariocandela/beelzebub.git
docker compose build
docker-compose up -d
```

You can find the precompiled container at the following link: <https://hub.docker.com/r/m4r10/beelzebub>

Now that you have executed Beelzebub, you will find several pre-configured honeypots within the project. They are located inside the `configurations/services` directory, try the simple SSH honeypot on port 22

```bash
ssh root@localhost
```

{% hint style="info" %}
Password: root&#x20;
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.beelzebub.ai/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.