Skip to content

Configuration

Susant Sahani edited this page Oct 18, 2026 · 1 revision

Configuration

krytond is configured by environment variables (internal/config). The variable names below appear in the source; for defaults and semantics see the docs named, since this page does not restate values it did not verify.

Area Variables
Core KRYTON_PROVIDER (demo, dockur, libvirt, kubevirt), KRYTON_ADDR, KRYTON_PROJECTS, KRYTON_DEFAULT_PROJECT, KRYTON_RECONCILE_INTERVAL, KRYTON_SHUTDOWN_TIMEOUT, KRYTON_CORS_ORIGINS
Auth KRYTON_AUTH_MODE (disabled, apikey; proxy auth also exists), KRYTON_API_KEYS_FILE, KRYTON_ALLOW_INSECURE, KRYTON_TRUST_PROXY, KRYTON_PROXY_SECRET_FILE, KRYTON_LAB_AUTO_AUTH, KRYTON_LAB_TOKEN_FILE
TLS KRYTON_TLS_CERT_FILE, KRYTON_TLS_KEY_FILE, KRYTON_CLIENT_CA_FILE
Rate limit KRYTON_RATE_LIMIT_RPS, KRYTON_RATE_LIMIT_BURST (off by default; 429 RATE_LIMITED)
KubeVirt KRYTON_KUBECONFIG, KRYTON_KUBERNETES_ENDPOINT, KRYTON_KUBERNETES_TOKEN_FILE, KRYTON_KUBERNETES_BEARER_TOKEN, KRYTON_KUBERNETES_CA_FILE, KRYTON_KUBERNETES_CLIENT_CERT_FILE, KRYTON_KUBERNETES_CLIENT_KEY_FILE, KRYTON_KUBERNETES_INSECURE_SKIP_VERIFY, KRYTON_NAMESPACE_PREFIX, KRYTON_IMAGE_NAMESPACE, KRYTON_STORAGE_CLASS
libvirt KRYTON_LIBVIRT_URI (local only; remote URIs rejected), KRYTON_LIBVIRT_DATA_DIR, KRYTON_LIBVIRT_NETWORK, KRYTON_LINUX_IMAGE_DIR
dockur KRYTON_DOCKUR_PUBLIC_HOST, KRYTON_DOCKUR_DATA_DIR, KRYTON_DOCKUR_RUNTIME, KRYTON_DOCKUR_HTTP_BASE, KRYTON_DOCKUR_RDP_BASE
Images KRYTON_IMAGES_FILE, KRYTON_GOLDEN_DIR, KRYTON_WINDOWS_IMAGE (golden-image scripts)
Events KRYTON_EVENTS_FILE, KRYTON_EVENT_WEBHOOK_URL, KRYTON_EVENT_WEBHOOK_SECRET
State files KRYTON_STORAGE_CONFIG_FILE, KRYTON_SETTINGS_CONFIG_FILE
Atlas KRYTON_ATLAS_URL, KRYTON_ATLAS_TOKEN, KRYTON_ATLAS_PRODUCT
Client (krytonctl) KRYTON_URL, KRYTON_TOKEN, KRYTON_PROJECT

Rules stated in the docs:

  • Production kubevirt refuses to start with auth disabled unless KRYTON_ALLOW_INSECURE=true; libvirt likewise.
  • API keys are stored as SHA-256 digests; the keys file uses a {"keys":[...]} wrapper (docs/AUTH.md). Mint a digest with krytonctl hash-token TOKEN.
  • Helm values (e.g. rateLimit.rps, replicaCount: 1) are documented in deploy/helm/kryton/README.md.

Example libvirt setup: see docs/LINUX-TEMPLATES.md.

Clone this wiki locally