> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sundew.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Deploy your first Sundew honeypot in 5 minutes

## Install

<Tabs>
  <Tab title="Docker (recommended)">
    ```bash theme={null}
    docker run -p 8080:8080 karpie28/sundew
    ```

    Pulls the latest image from Docker Hub and starts Sundew with a randomly generated persona.
  </Tab>

  <Tab title="pip">
    ```bash theme={null}
    pip install sundewsh
    sundew serve
    ```
  </Tab>

  <Tab title="From source">
    ```bash theme={null}
    git clone https://github.com/sundew-sh/sundew.git
    cd sundew && make run
    ```
  </Tab>
</Tabs>

Sundew is now running on `http://localhost:8080` with a randomly generated persona.

## Explore what's running

Open a second terminal and see what AI agents would discover:

```bash theme={null}
# AI plugin manifest
curl http://localhost:8080/.well-known/ai-plugin.json

# OpenAPI spec
curl http://localhost:8080/openapi.json

# Hit a persona-generated endpoint
curl http://localhost:8080/api/v2/transactions
```

Every response is shaped by the persona. A different deployment would have completely different endpoints, company names, and data.

## Query captured sessions

After traffic has flowed through:

```bash theme={null}
# See the most recent session
sundew query --last-session

# Filter for AI agent traffic
sundew query --type ai_agent --last 24h

# Quick stats
sundew stats
```

## Use with Claude (MCP)

Add Sundew as an MCP server to query your honeypot data directly from Claude:

```json theme={null}
{
  "mcpServers": {
    "sundew": {
      "command": "sundew",
      "args": ["mcp-client"]
    }
  }
}
```

## Next steps

<CardGroup cols={2}>
  <Card title="How it works" icon="diagram-project" href="/concepts/how-it-works">
    Understand the full architecture
  </Card>

  <Card title="Configuration" icon="gear" href="/guides/configuration">
    Customize traps, LLM, and storage
  </Card>

  <Card title="Custom personas" icon="masks-theater" href="/guides/custom-personas">
    Build industry-specific personas
  </Card>

  <Card title="Deployment" icon="cloud" href="/guides/deployment">
    Production deployment with Docker
  </Card>
</CardGroup>