Configuration

Meerkat reads configuration from a text file in TOML format. By default meerkat reads from a file named meerkat.toml in the current working directory. An alternative file may be specified with the -config flag. For example:

meerkat -config /etc/meerkat.toml

The following configuration options are available:

HTTPAddr: The address, in host:port format, to serve meerkat from. For example 0.0.0.0:6969. The default is “:8585” i.e. all IPv4, IPv6 addresses port 8585.

IcingaURL: A URL pointing to an instance of Icinga serving the HTTP API. Meerkat can connect to Icinga to create dashboard elements from Icinga objects. This is usually a HTTPS URL with port 5665. For example https://icinga.example.com:5665. The default is using the loopback address and the default Icinga port https://127.0.0.1:5665.

IcingaUsername, IcingaPassword: The username and password with which to authenticate to Icinga. The default value for both is meerkat.

IcingaInsecureTLS: If set to true, verification of the TLS certificates served by the Icinga API is skipped. This is often required when Icinga is configured with self-signed certificates. The default is false.

AdminUsername, AdminPassword: Setting this username and password pair enables the in-development meerkat authentication feature. When enabled, all dashboards are read-only unless a user authenticates successfully. By default these are unset.

CacheExpiryDurationSeconds: number of seconds which meerkat will cache Icinga objects before requesting from the Icinga server again. The default is 16 seconds.

CacheSizeBytes: Total size of the Icinga object cache in bytes. If this size is reached, objects are evicted; oldest first. The default is 20971520 (20MB).