| next | adapter-settings.md |
|---|
::: warning ATTENTION Never rely solely on configurations produced by LLMs like ChatGPT! Always verify the generated configurations against the relevant documentation. Not doing so can potentially break your setup. :::
Zigbee2MQTT is configured using YAML based configuration.yaml file.
The file have to be located in the data directory within your installation. The data directory and the configuration.yaml has to be writeable for Zigbee2MQTT process because it can get updated - e.g. if you change the settings in the frontend. It's possible specify a custom data directory by setting the ZIGBEE2MQTT_DATA environment variable.
::: tip CONVENTION
The dot-notation of a config-key like mqtt.server means server property within the mqtt
section. All dot-notation references are absolute.
:::
It is possible to override the values in configuration.yaml via environment variables. The name of the environment
variable should start with ZIGBEE2MQTT_CONFIG_ followed by the path to the property you want to set in uppercase split
by a _.
In case you want to for example override:
mqtt:
base_topic: zigbee2mqttset ZIGBEE2MQTT_CONFIG_MQTT_BASE_TOPIC to the desired value.
Configuration options can be changed at runtime by publishing the appropriate MQTT payload with the topic zigbee2mqtt/bridge/request/options.
See MQTT Topics and Messages for details.
::: tip NOTE Some options will require a restart before being effective. :::