Docs menu

Self-hosting

compose up. Two containers plus data.

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

ServiceRole
apiFastAPI control plane
workerAsync jobs
frontendConsole
postgresSystem of record
redisQueue / cache
minioObject 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

Before writing SDK code

  • Install the agent skill or read Agent skill
  • Read Best practices — what a good receipt looks like
  • Trust boundary: @check after, @approve before
  • init() — zero required args, never throws
  • Mark estimated: true until a check is a hard fact
  • Shipped vs backlog: Introduction status table

Page: Self-hosting
HTML: https://docs.agenko.app/self-hosting
Markdown: https://docs.agenko.app/self-hosting.md