Kaiten
Self-Hosting

Environment Variables

Complete reference of all Kaiten configuration variables.

Environment Variables

Core API

VariableRequiredDefaultDescription
KAITEN_PORTNo6000API server port
KAITEN_DATABASE_CONNECTION_STRINGYes—PostgreSQL DSN
KAITEN_DATABASE_PORTNo5452Database port
KAITEN_DATABASE_USERNokaitenDatabase user
KAITEN_DATABASE_PASSWORDYes—Database password
KAITEN_DATABASENokaitenDatabase name
KAITEN_SEED_PROFILENodefaultSeeder profile (default, kaiten-sushi-shop)

Authentication

VariableRequiredDefaultDescription
CLERK_SECRET_KEYYes—Clerk secret key for JWT validation
CLERK_WEBHOOK_SECRETNo—Clerk webhook signing secret
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYYes (frontend)—Clerk publishable key

Webhooks (Svix)

VariableRequiredDefaultDescription
SVIX_API_KEYNo—Svix API key. If unset, webhooks are disabled
SVIX_SERVER_URLNo—Self-hosted Svix URL

Event Pipeline

VariableRequiredDefaultDescription
RABBITMQ_URLNo—RabbitMQ connection URL
DAPR_HTTP_PORTNo3500Dapr sidecar port

Observability

VariableRequiredDefaultDescription
KAITEN_OTEL_ENABLEDNofalseEnable OpenTelemetry
KAITEN_OTEL_ENDPOINTNo—OTLP exporter endpoint
KAITEN_OTEL_SERVICE_NAMENokaiten-apiService name in traces
KAITEN_OTEL_INSECURENotrueUse insecure connection

MCP Server

VariableRequiredDefaultDescription
MCP_API_URLNohttp://kaiten-api:4000Internal API URL
MCP_OPENAPI_URLNo—OpenAPI spec URL

On this page