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
IcingaPassword: The username and password with which to authenticate to Icinga. The default value for both is
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.
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).