Kaiten
Self-Hosting

Environment Variables

Complete reference of all Kaiten configuration variables.

Environment Variables

Core API

VariableRequiredDefaultDescription
KAITEN_PORTNo6000API server port
KAITEN_DATABASE_CONNECTION_STRINGYesPostgreSQL DSN
KAITEN_DATABASE_PORTNo5452Database port
KAITEN_DATABASE_USERNokaitenDatabase user
KAITEN_DATABASE_PASSWORDYesDatabase password
KAITEN_DATABASENokaitenDatabase name
KAITEN_SEED_PROFILENodefaultSeeder profile (default, kaiten-sushi-shop)

Authentication

VariableRequiredDefaultDescription
CLERK_SECRET_KEYYesClerk secret key for JWT validation
CLERK_WEBHOOK_SECRETNoClerk webhook signing secret
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYYes (frontend)Clerk publishable key

Webhooks (Svix)

VariableRequiredDefaultDescription
SVIX_API_KEYNoSvix API key. If unset, webhooks are disabled
SVIX_SERVER_URLNoSelf-hosted Svix URL

Event Pipeline

VariableRequiredDefaultDescription
RABBITMQ_URLNoRabbitMQ connection URL
DAPR_HTTP_PORTNo3500Dapr sidecar port

Observability

VariableRequiredDefaultDescription
KAITEN_OTEL_ENABLEDNofalseEnable OpenTelemetry
KAITEN_OTEL_ENDPOINTNoOTLP 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_URLNoOpenAPI spec URL

On this page