Clone
2
Configuration
Kierre edited this page 2025-11-27 23:43:12 +01:00

Configuration

Vona is configured using a TOML file. This can be specified in the environment variable VONA_CONFIG, and if absent, will default to /etc/vona/config.toml.

Environment variables are not supported to configure other aspects of Vona.

The configuration can be validated before starting the main Vona process by running python3 -m vona.config.

If you update the configuration file, you must restart Vona for the changes to take effect.

Top-level

NOTE: The * symbol indicates that the field is required.

Field Type Description Default
server_name* str The server domain name. Can be changed later N/A
signing_key* str The signing key Vona will use. N/A
signing_key_path str Path to the signing key Vona will use. N/A
address str The address Vona will bind to 127.0.0.1
port int The port Vona will bind to 5000
cat str Path to the cat photo. The file must exist and be a JPEG /etc/vona/cat.jpg
the_funny_number int The funny number 1337
enable_registration bool Whether to allow user registration false
enable_debug_logs bool Whether to enable debug logs false
log_level str The log level. May be one of ["WARN", "ERROR", "INFO", "DEBUG"] (nightly) INFO

Support

Field Type Description Default
mxid str The admin MXID N/A
email str The admin email N/A