# Reference

The precise, technical reference for the Kortix manifest, CLI, runtime, and config boundary.

Canonical page: https://kortix.com/docs/reference

Every field, default, flag, endpoint, and validator. Plain-language versions live in [Core concepts](/docs/concepts) and the [Guides](/docs/guides).

- [Manifest (kortix.yaml)](/docs/reference/manifest): Every field, default, and validation rule — v2 (`kortix.yaml`) and legacy v1 (`kortix.toml`).
- [CLI reference](/docs/reference/cli): Every `kortix` command, token scopes, env vars, exit codes.
- [Self-hosting](/docs/reference/cli#self-host): The `kortix self-host` command surface — one generic Docker system, laptop or any box.
- [Self-hosting architecture](/docs/reference/self-hosting-architecture): How the Compose stack fits together: Caddy, the app containers, official Supabase Docker, the in-compose updater.
- [Change requests](/docs/reference/change-requests): Data model, lifecycle, diff/merge semantics, CLI, REST API.
- [Session runtime](/docs/reference/session-runtime): Lifecycle, branch model, sandbox layout, injected env, daemon.
- [Secrets](/docs/reference/secrets): How `project_secrets` flow from the manifest to your sandbox.
- [Triggers](/docs/reference/triggers): Cron and signed-webhook entries — fields, template vars.
- [Sandbox image](/docs/reference/sandbox-image): The layered Docker image, what Kortix injects, rebuilds.
- [Kortix vs OpenCode config](/docs/reference/config-boundary): The ownership boundary between the manifest and `.kortix/opencode/`.