This documentation site is about the unstable (upcoming) Comentario version.
Switch to the stable version »
Backend configuration
Configuring Comentario server
Comentario backend (server) has two sets of parameters.
- Static configuration, which can only be set or changed at server start-up. These parameters can be configured using command-line options or environment variables.
- Dynamic items, which can be changed at runtime and apply immediately.
The Comentario server’s static (start-up) configuration can be defined in three ways, in order of precedence:
- YAML configuration file
- Command-line options
- Environment variables
All three methods are functionally equivalent, but precedence applies: values in the configuration file override command-line options, which in turn override environment variables. Availability of each method depends on the specific setting.
Comentario retrieves sensitive data (secrets), which are part of the static backend configuration, from two main sources:
- A YAML file;
- Environment variables (or files they reference).
If both sources are provided, environment variables take precedence.
The dynamic, or runtime, configuration of Comentario server can be set in the Administration UI.