Skip to main content
Complete reference for all kombify AI configuration options.

​
Environment variables

​
Core settings

VariableDefaultDescription
KOMBIFY_AI_MODEsaasDeployment mode: saas or selfhosted
KOMBIFY_AI_PORT5270HTTP API port
KOMBIFY_TECHSTACK_URL—URL of the kombify TechStack instance
KOMBIFY_AI_LOG_LEVELinfoLog level: debug, info, warn, error

​
Authentication

VariableDefaultDescription
KOMBIFY_AI_ZITADEL_ISSUER—Zitadel OIDC issuer URL
KOMBIFY_AI_ZITADEL_CLIENT_ID—OIDC client ID
KOMBIFY_AI_JWT_AUDIENCE—Expected JWT audience

​
Database

VariableDefaultDescription
KOMBIFY_AI_DB_TYPEsqliteDatabase type: sqlite or postgres
KOMBIFY_AI_DB_URL./data/ai.dbDatabase connection string

​
AI providers

VariableDefaultDescription
OPENAI_API_KEY—OpenAI API key
ANTHROPIC_API_KEY—Anthropic API key
GOOGLE_AI_API_KEY—Google AI API key
OLLAMA_BASE_URLhttp://localhost:11434Ollama endpoint

​
Guard settings

VariableDefaultDescription
KOMBIFY_GUARD_ENABLEDfalseEnable Guard autonomous monitoring
KOMBIFY_GUARD_TRUST_LEVELobserverInitial trust: observer, advisor, autonomous
KOMBIFY_GUARD_FAST_INTERVAL10sFast loop interval
KOMBIFY_GUARD_HEARTBEAT_INTERVAL60sHeartbeat loop interval
KOMBIFY_GUARD_DEEP_INTERVAL6hDeep scan interval

​
Docker Compose example

services:
  kombify-ai:
    image: ghcr.io/kombify/ai:latest
    ports:
      - "5270:5270"
    environment:
      - KOMBIFY_AI_MODE=selfhosted
      - KOMBIFY_TECHSTACK_URL=http://techstack:5260
      - KOMBIFY_AI_DB_TYPE=sqlite
      - KOMBIFY_GUARD_ENABLED=true
      - KOMBIFY_GUARD_TRUST_LEVEL=observer
    volumes:
      - ai-data:/data

volumes:
  ai-data:

​
Further reading

BYOK setup

Configure API keys for self-hosted mode

Quick start

Get started with kombify AI