Configuration
Last updated Oct 12, 2026
Last updated Oct 12, 2026
Every project has an ember.toml (or ember.jsonc) file that tells kiln how to build and deploy it.
- ember.toml
- ember.jsonc
name = "my-first-ember"
main = "src/index.ts"
compatibility_date = "2026-09-01"
[vars]
GREETING = "hello"
[[kv_namespaces]]
binding = "CACHE"
id = "b1d2…"{
"name": "my-first-ember",
"main": "src/index.ts",
"compatibility_date": "2026-09-01",
"vars": { "GREETING": "hello" },
"kv_namespaces": [{ "binding": "CACHE", "id": "b1d2…" }]
}Top-level keys
Key | Required | Description |
|---|---|---|
| Yes | The Ember's name; also its subdomain |
| Yes | The entry file |
| Yes | Pins runtime behaviour to a date |
| No | Custom domains or path patterns to run on |
| No | Plain-text environment variables |
compatibility_date lets us fix runtime bugs without breaking you. Move it forward deliberately, and read the changelog when you do.
Was this helpful?