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

# Self-Hosting

> Run Aden Hive on your own infrastructure

<Warning>
  Self-hosting guidance is in active iteration. Use this page as an alpha baseline and validate against the latest `hive/README.md` before production rollout.
</Warning>

## Overview

Self-hosting Hive gives you control over runtime environment, networking, and credentials.

## Baseline Setup

1. Clone and prepare the repository:

```bash theme={null}
git clone https://github.com/adenhq/hive.git
cd hive
./quickstart.sh
```

2. Configure provider credentials (for example):

```bash theme={null}
export ANTHROPIC_API_KEY="sk-ant-..."
```

3. Run agents from your own infrastructure:

```bash theme={null}
PYTHONPATH=exports uv run python -m your_agent_name run --input '{...}'
```

## Deployment Notes

* Prefer isolated environments (container, VM, or dedicated host)
* Keep credential material in secure secret stores
* Use environment-scoped configs for staging vs production
* Add observability and alerting before enabling autonomous workflows

> **Complete Deployment Story**: Self-hosting covers the infrastructure setup. For comprehensive guidance on deployment strategies, monitoring, and safe rollout procedures, see the [deployment guide](/building/deployment).

## Troubleshooting

### Dependency setup issues

```bash theme={null}
uv sync
uv run python -c "import framework, aden_tools; print('ok')"
```

### Runtime import issues

Run commands from the `hive/` project root and ensure `PYTHONPATH=exports` is set.

## Need Help?

<Card title="Book a Discovery Call" icon="calendar" href="https://calendly.com/contact_aden/discovery-call">
  Get help with production deployment and architecture decisions.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="rocket" href="/getting-started/quickstart">
    Set up local development and first execution
  </Card>

  <Card title="Build Your First Agent" icon="hammer" href="/building/first-agent">
    Create and test your first goal-driven agent
  </Card>

  <Card title="Deployment Guide" icon="rocket" href="/building/deployment">
    Move your agent from development to production safely
  </Card>

  <Card title="Monitoring and Ops" icon="chart-line" href="/building/monitoring">
    Track agent health and performance in production
  </Card>
</CardGroup>