Skip to main content
Version: 1.12



This document is applicable only for self-hosted installations. For Botkube Cloud installations, the Botkube Agent configuration is managed via the Botkube Cloud dashboard.

The general settings holds a general configuration for the Botkube Agent. For example, log level, disabling config watcher and similar.


# General Botkube configuration.
# Cluster name to differentiate incoming messages.
clusterName: not-configured
# If true, notifies about new Botkube releases.
upgradeNotifier: true
# Botkube logging settings.
# Sets one of the log levels. Allowed values: `info`, `warn`, `debug`, `error`, `fatal`, `panic`.
level: info
# Configures log format. Allowed values: `text`, `json`.
formatter: json
# If true, disable ANSI colors in logging. Ignored when `json` formatter is used.
disableColors: false

# Parameters for the Config Watcher component which reloads Botkube on ConfigMap changes.
# It restarts Botkube when configuration data change is detected. It watches ConfigMaps and/or Secrets with the ` "true"` label from the namespace where Botkube is installed.
# If true, restarts the Botkube Pod on config changes.
enabled: true
# In-cluster Config Watcher configuration. It is used when remote configuration is not provided.
# Resync period for the Config Watcher informers.
informerResyncPeriod: 10m

The default configuration for Helm chart can be found in the values.yaml file.