# leilani.json reference

Place one `leilani.json` at the Cargo workspace root, alongside its `Cargo.toml`. It configures the whole Leilani workspace. Use valid JSON, without comments or trailing commas. Commit changes and push to deploy them; Config shows the parsed configuration and is read-only.

Top-level configuration fields

| Field | Type / default | Behavior |
| --- | --- | --- |
| postgres | Boolean; false | Enables a dedicated PostgreSQL instance on deployment. See [PostgreSQL](https://leilani.dev/docs/postgres.md) for connection settings and persistence. |
| packages | Object; {} | Selects the executables to launch and their arguments and restart policies. |
| http | Object; defaults below | Maps public hostnames to application ports and configures static files and request body limits. |
| users | Array; \[\] | Defines application users for HTTP Basic authentication. |
| rules | Array; \[\] | Requires authentication and roles for matching HTTP requests. With no matching rule, Leilani permits the request. |

All five top-level fields are optional. An empty configuration starts no packages and defines no HTTP listeners. There is no separate `domains` field: hostnames belong in `http.binds`.
