# [[webUI]] Setup The channel number was specified in `/opt/zigbee2mqtt/data/configuration.yaml`, but can also be changed from the [[webUI]]. ![[zigbee2mqtt-setup-0.png]] ![[zigbee2mqtt-setup-1.png]] ![[zigbee2mqtt-setup-2.png]] A view of how messages are handled by the [[MQTT]] broker. ![[zigbee2mqtt-mqtt-0.png]] # Error on Channel Change If we change the [[Zigbee]] channel number, [[Zigbee2MQTT]] will fail to start with the following errors: ![[zigbee2mqtt-setup-error--0.png]] # Error Recovery This is what we have to do to get things going again. ```cli rm /opt/zigbee2mqtt/data/coordinator_backup.json ``` > [!cli]+ <code class="g-code">nano /opt/zigbee2mqtt/data/configuration.yaml</code> > >```YAML >homeassistant: true >frontend: true >permit_join: false >mqtt: > base_topic: zigbee2mqtt > server: mqtt://192.168.0.111 >serial: > port: tcp://192.168.0.112:6638 > baudrate: 115200 >advanced: > transmit_power: 20 > channel: 25 > network_key: > - 120 > - 21 > - 166 > - 69 > - 181 > - 37 > - 246 > - 104 > - 137 > - 225 > - 169 > - 172 > - 75 > - 119 > - 53 > - 117 > pan_id: 6594 > ext_pan_id: > - 188 > - 133 > - 53 > - 72 > - 81 > - 167 > - 136 > - 68 >#### remove or comment the lines below ># homeassistant_legacy_entity_attributes: false ># legacy_api: false ># legacy_availability_payload: false >#device_options: ># legacy: false >``` reboot to test you can access [[Zigbee2MQTT]] ```cli reboot ``` ensure you can access the [[Zigbee2MQTT]] [[webUI]] <code class="o-code"> http://192.168.0.222:8080</code> # Configuration Refresh To start with a clean configuration, without reinstalling [[Zigbee2MQTT]], follow the steps below. Note you will have to pair again all [[Zigbee]] devices if you `GENERATE` any of the `network_key`, `pan_id`, `ext_pan_id`. ## SMLight SLZB-06M > [!cli]+ <code class="g-code">nano /opt/zigbee2mqtt/data/configuration.yaml</code> > >```YAML >homeassistant: true >frontend: true >permit_join: false >mqtt: > base_topic: zigbee2mqtt > server: mqtt://192.168.0.111 >serial: > port: tcp://192.168.0.112:6638 > baudrate: 115200 > adapter: ember # ezsp although it works it is considered legacy >advanced: > transmit_power: 20 > channel: 25 > network_key: GENERATE > pan_id: GENERATE > ext_pan_id: GENERATE > # if anything below this line, remove or comment out >``` ## SMLight SLZB-06p7 > [!cli]+ <code class="g-code">nano /opt/zigbee2mqtt/data/configuration.yaml</code> > >```YAML >homeassistant: true >frontend: true >permit_join: false >mqtt: > base_topic: zigbee2mqtt > server: mqtt://192.168.0.111 >serial: > port: tcp://192.168.0.112:6638 > baudrate: 115200 > adapter: zstack >advanced: > transmit_power: 20 > channel: 25 > network_key: GENERATE > pan_id: GENERATE > ext_pan_id: GENERATE > # if anything below this line, remove or comment out >``` ## ZigStar UZG-01 > [!cli]+ <code class="g-code">nano /opt/zigbee2mqtt/data/configuration.yaml</code> > >```YAML >homeassistant: true >frontend: true >permit_join: false >mqtt: > base_topic: zigbee2mqtt > server: mqtt://192.168.0.111 >serial: > port: tcp://192.168.0.112:6638 > baudrate: 115200 > adapter: zstack >advanced: > transmit_power: 20 > channel: 25 > network_key: GENERATE > pan_id: GENERATE > ext_pan_id: GENERATE > # if anything below this line, remove or comment out >``` ## [[Zigbee2MQTT]] ```cli rm /opt/zigbee2mqtt/data/coordinator_backup.json ``` ```cli rm /opt/zigbee2mqtt/data/database.db ``` ```cli rm /opt/zigbee2mqtt/data/state.json ``` ```cli cd /opt/zigbee2mqtt ``` ```cli npm start ``` reboot to test you can access [[Zigbee2MQTT]] ```cli reboot ``` ensure you can access the [[Zigbee2MQTT]] [[webUI]] <code class="o-code"> http://192.168.0.222:8080</code> ![[Zigbee2MQTT#References]] # Follow or Support me -> <a href='https://ko-fi.com/S6S0K9U5Q' target='_blank'><img height='36' style='border:0px;height:36px;float:right; ' src='https://storage.ko-fi.com/cdn/kofi1.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>