The Kordfile
Declare your whole stack — apps, ports, env, dependencies, health checks, and routing.
The Kordfile is a plain-text file at your project root that declares every app kordrun should run. It's whitespace-indented, with one block per app.
Configuration
Top-level directives
| Directive | Example | Description |
|---|---|---|
workspace | workspace "Acme" | A label for this project, shown in the dashboard. |
proxy_port | proxy_port 8000 | Port for the built-in reverse proxy (default 80). |
app | app web | Starts an app block; following indented lines configure it. |
App attributes
app web
path ./apps/web
run npm run dev
port 3000
env NODE_ENV development
depends api
health /healthz
proxy web.local
route /
logs web.logProp
Type
Example
workspace "Acme"
proxy_port 8000
app db
run docker compose up postgres
port 5432
app api
run cargo run
port 4000
health /healthz
depends db
proxy api.local
app web
run npm run dev
port 3000
depends api
proxy app.localRun it with kordrun start.