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.

Static configuration

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.

Secrets

Comentario stores its sensitive data in a YAML file called secrets. The secrets file is a part of static backend configuration.

Dynamic configuration

The dynamic, or runtime, configuration of Comentario server can be set in the Administration UI.

See also