General configurations

Configuration parameters

Name	Type	Default value	Possible values	Description
compatibilityPolicy	string	strict	strict, loose	The compatibility policy controls how GatewayD treats plugins’ requirements. If a plugin requires a specific version of another plugin, the compatibility policy controls whether to allow or reject the plugin. - strict (default): the plugin is rejected if it requires a specific version of another plugin and that version is not the one currently loaded. - loose: the plugin is allowed to run even if it requires a specific version of another plugin and that version is not the one currently loaded.
enableMetricsMerger	boolean	True	True, False	If enabled, GatewayD will merge the Prometheus metrics of all plugins over Unix domain socket. The metrics are merged and exposed via the GatewayD metrics endpoint via HTTP.
metricsMergerPeriod	string	5s	Valid duration strings	The metrics merger period controls how often the metrics merger should collect and merge metrics from plugins.
healthCheckPeriod	string	5s	Valid duration strings	The health check period controls how often the health check should be performed. The health check is performed by pinging each plugin. Unhealthy plugins are removed.
reloadOnCrash	boolean	True	True, False	If enabled, GatewayD will reload the plugin if it crashes. The crash is detected by the health check.
timeout	string	30s	Valid duration strings	The timeout controls how long to wait for a plugin to respond to a request before timing out.
startTimeout	string	1m	Valid duration strings	The start timeout controls how long to wait for a plugin to start before timing out.
policyTimeout	string	30s	Valid duration strings	The policy timeout controls how long to wait for a policy to evaluate before timing out.
policies	array	[]	An array of objects	The policies are a set of rules that are evaluated against the signals to determine whether the actions should be executed.
actionTimeout	string	30s	Valid duration strings	The action timeout will set a default timeout for all the actions that are going to be executed. Action specific timeout has priority over this value. Set to 0 to remove default action timeout.

Example configuration

compatibilityPolicy: "strict"
enableMetricsMerger: True
metricsMergerPeriod: 5s
healthCheckPeriod: 5s
reloadOnCrash: True
timeout: 30s
startTimeout: 1m
policyTimeout: 30s
actionTimeout: 30s
policies:
  name: terminate
  policy: "Signal.terminate == true && Policy.terminate == 'stop'"
  metadata:
    terminate: "stop" # Change this to "continue" to continue the execution