Configuration & variables
La configuration se charge par couches, surchargée en dernier par les variables d'environnement. Le core utilise le préfixe KV__ (double underscore comme séparateur).
Ordre de précédence (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)Variables du core (extrait) #
| Variable | Rôle |
|---|---|
KV__SERVER__PORT | Port d'écoute du core (défaut 8080). |
KV__SERVER__INTERNAL_SECRET | Secret partagé pour l'enregistrement des modules. |
KV__DATABASE__URL | DSN PostgreSQL (caractères spéciaux URL-encodés). |
KV__AUTH__JWT_SECRET | Secret de signature des JWT (aléatoire, long). |
KV__STORAGE__LOCAL_PATH | Chemin du backend de stockage local. |
Note
Le séparateur est un double underscore : KV__SERVER__PORT correspond à [server] port. Côté module, le préfixe suit la même logique (ex. KC__ pour calendar), et les identifiants DB sont injectés par le superviseur (KUBUNO_DB_*).
Alternative en champs #
Plutôt que KV__DATABASE__URL, vous pouvez fournir KV__DATABASE__HOST, …__PORT, …__USER, …__PASSWORD, …__DATABASE — pratique pour éviter l'encodage d'URL des mots de passe.