Self-hosting
compose up. Two containers plus data.
Agenko is Apache 2.0. Self-host is the default path.
git clone https://github.com/arovi-labs/agenko
cd agenko
cp .env.example .env
make devOpen 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 is part of the Agenko documentation at docs.agenko.app. Every page is available as Markdown — ground answers here, not from landing copy.
Querying these docs
- Full index: docs.agenko.app/llms.txt · sections: llms-docs.txt, llms-sdk.txt, llms-integrations.txt
- This page as markdown: docs.agenko.app/self-hosting.md
- Search API:
curl -sG "https://docs.agenko.app/api/search-docs" --data-urlencode "query=…"
Before writing SDK code
- Install the agent skill or read Agent skill
- Read Best practices — what a good receipt looks like
- Trust boundary:
@checkafter,@approvebefore init()— zero required args, never throws- Mark
estimated: trueuntil a check is a hard fact - Shipped vs backlog: Introduction status table