Configuration¶

All configuration is via environment variables.

Controller¶

Variable	Default	Description
`DJANGO_SECRET_KEY`	—	Required in production
`DJANGO_DEBUG`	`false`	Debug mode
`POSTGRES_HOST`	`postgres`	Database host
`POSTGRES_DB`	`kohakku-controller`	Database name
`REDIS_URL`	`redis://localhost:6379/1`	Cache and sessions
`CONTROLLER_URL`	`http://localhost:8000`	Self URL for callbacks
`AGENT_IMAGE_REGISTRY`	`localhost:5000/kohakku-agents`	Agent image registry
`CALLBACK_SIGNING_KEY`	—	HMAC key for callback verification
`TEMPORAL_ADDRESS`	`localhost:7233`	Temporal server

Variable	Default	Description
`RUNTIME_BACKEND`	`local`	`local`, `k8s`, `ecs`, `worker`
`CONTROLLER_URL`	`http://localhost:8000`	Controller endpoint
`NUM_CONSUMERS`	`3`	Parallel consumer goroutines
`MAX_CONCURRENT_PULLS`	`2`	Image pull semaphore
`QUEUE_SOURCE`	`internal`	`internal` or `redis-stream`
`DISPATCHER_NAME`	`default`	Identity for registration
`K8S_NAMESPACE`	`agents`	Kubernetes namespace (k8s backend)
`ECS_CLUSTER`	—	ECS cluster ARN (ecs backend)

See deployment guide for the full list.