Configuration & variables

Configuration loads in layers, with environment variables taking final precedence. The core uses the KV__ prefix (double underscore as separator).

Precedence order (core) #

1. Valeurs par défaut (code)
2. config.toml (répertoire courant — dev)
3. /etc/kubuno/config.toml (production)
4. Variables d'environnement KV__…  (surcharge finale)

Core variables (excerpt) #

Variable	Purpose
`KV__SERVER__PORT`	The core's listening port (default 8080).
`KV__SERVER__INTERNAL_SECRET`	Shared secret for module registration.
`KV__DATABASE__URL`	PostgreSQL DSN (special characters URL-encoded).
`KV__AUTH__JWT_SECRET`	JWT signing secret (random, long).
`KV__STORAGE__LOCAL_PATH`	Path of the local storage backend.

Note

The separator is a double underscore: KV__SERVER__PORT maps to [server] port. On the module side the prefix follows the same logic (e.g. KC__ for calendar), and DB credentials are injected by the supervisor (KUBUNO_DB_*).

Field-based alternative #

Instead of KV__DATABASE__URL, you can provide KV__DATABASE__HOST, …__PORT, …__USER, …__PASSWORD, …__DATABASE — handy to avoid URL-encoding passwords.