---
title: Self-hosting
description: compose up. Two containers plus data.
---

# Self-hosting

Agenko is Apache 2.0. Self-host is the default path.

```bash
git clone https://github.com/arovi-labs/agenko
cd agenko
cp .env.example .env
make dev
```

Open `http://localhost:3000`. API on `:8000`.

## Compose services

| Service | Role |
|---|---|
| `api` | FastAPI control plane |
| `worker` | Async jobs |
| `frontend` | Console |
| `postgres` | System of record |
| `redis` | Queue / cache |
| `minio` | Object storage |

Postgres-first stack with OTLP ingest and OpenInference attributes — not a fork of another observability backend.

## Auth

Dev can run without SuperTokens. Optional: SuperTokens for OAuth in self-host. OAuth secrets live in `agenko-frontend/.env.local`.

## Production notes

Helm, backups, and `docker-compose.prod.yml` are a later launch item. Until then: compose + resource limits you own. Set `REQUIRE_API_KEY=true` before any network you do not trust.

## BYOC

Point `AGENKO_HOST` at your API. SDKs do not care if that host is localhost or your VPC.

## Agent instructions

This page: https://docs.agenko.app/self-hosting.md

Fetch `/llms.txt` for the full index. Search: `GET /api/search-docs?query=...`
