Expand description
main.toml — the top-level server configuration.
Every field is optional: a missing file, or a file missing any given key,
falls back to a safe default. The only piece of configuration that is
inferred rather than declared is TLS: if the app directory contains an
https/ folder with a cert + key, the server serves HTTPS.
§Environment variables
Any string value here — like any string in any of the app’s TOML files — may
reference the environment: url = "$DATABASE_URL",
port = "${PORT:-8080}". See crate::env for the syntax.
Structs§
- Admin
AiAssistance Config - Extra browser-side prompting that fills text fields through the app’s configured AI provider.
- Admin
Config - The built-in admin dashboard, served from the binary itself.
- AiConfig
- An AI chat assistant: which service answers, and what to say to it.
- AppConfig
- What the app calls itself.
- Auth
Config - Cache
Config - An optional Redis cache.
- Config
- Fully-resolved server configuration.
- Database
Config - Docs
Config - Interactive API documentation (OpenAPI spec + Swagger UI).
- Email
Config - Outbound email: which provider sends it, and the credentials to do so.
- Logs
Config - How the process writes to its own stdout.
- Metrics
Config - Metrics: the four numbers you page on, on the OpenTelemetry HTTP semantic conventions so a stock dashboard reads them without being taught the app.
- OAuth
Config - Signing in with somebody else’s account.
- OAuth
Provider Config - One provider’s credentials, and the overrides an unknown provider needs.
- Observability
Config - Logs, traces and metrics — what the server says about itself, and where it says it.
- Organization
Config - The
[organization]section: deployment-wide rules about the tenant itself. - Otlp
Config - Where the data goes.
- Payments
Config - Payments: who takes the money, and how the checkout is set up.
- Public
Config - Static files served from the app’s
public/directory. - Queues
Config - Background work: a message published now, handled by a function shortly after, outside the request that caused it.
- Rate
Limit Config - How many requests one client may make, before the API starts answering
429 Too Many Requests. - Server
Config - Smtp
Config - SMTP transport settings, used only when
provider = "smtp". - Storage
Config - Where uploaded files go.
- Traces
Config - Distributed traces: one span per request, children for the work inside it.