Configuration

Note

The documentation of the configuration options themselves can be found in the Inmanta configuration reference.

Inmanta server and Inmanta agent

The Inmanta server and the Inmanta agent, started via systemd, will read their configuration from the following locations:

  1. /etc/inmanta/inmanta.cfg

  2. /etc/inmanta/inmanta.d/*.cfg

  3. environment variables

The configuration options specified in the /etc/inmanta/inmanta.d/ directory override the configuration options specified in /etc/inmanta/inmanta.cfg. If the directory /etc/inmanta/inmanta.d/ contains two files with the same configuration option, the conflict is resolved using the alphabetical order of the filenames. Filenames which appear later in the alfabetical order override the configuration options from their predecessors in that order.

After having read the configuration files, inmanta will read environment variables. The environment variables overwrite any other types of configuration, if set. All settings can be set using environment variables with the following convention:

INMANTA_{section.name}_{setting.name}

Keep in mind that everything should be in ALL CAPS and that any dashes in the setting names must be replaced by underscores.

Inmanta CLI tool

The inmanta CLI tool reads its configuration at the following locations:

  1. /etc/inmanta/inmanta.cfg

  2. /etc/inmanta/inmanta.d/*.cfg (override using the --config-dir option)

  3. ~/.inmanta.cfg

  4. .inmanta

  5. .inmanta.cfg

  6. The config file specified on the CLI using the -c options

  7. Environment variables

The inmanta CLI tool searches for the .inmanta and .inmanta.cfg files in the directory where the CLI command is executed.

Configuration files which are ranked lower in the above-mentioned list override the configuration options specified by their predecessors. If the directory /etc/inmanta/inmanta.d/ contains two files with the same configuration option, the conflict is resolved using the alphabetical order of the filenames. Filenames which appear later in the alphabetical order override the configuration options from their predecessors in that order.

The number 2 (/etc/inmanta/inmanta.d/*.cfg) in the above-mentioned list can be overridden using the --config-dir option of the inmanta command. More information about these options can be found in the inmanta command reference