Change zigbee secure network key, Zigbee2MQTT

A short follow-up, as reference for others in the same situation. My change was done on a RPi4 using HAOS and Zigbee2MQTT in supervisor.

  1. Do a backup, to get back if you run into problems
  2. Stop Zigbee2MQTT
  3. Change the network key
  4. Change the PANID (I changed my PANID to 1, it is not important for security, however solve interference from the old network, where the devices will be looking for the coordinator)
  5. Delete the configuration backup file.
  6. Repower HA, to ensure the coordinator get power recycled (found out by trial and error)
  7. When up, there might be errors in zigbee2mqtt log about network not established. If yes, then do a reboot (not sure why, I expierenced it)
  8. Zigbee2MQTT should start. Some device errors might happen as they are not paired, I got quite a few as the devices are not there.
  9. Set zigbee2mqtt to pairing mode (remember it only is in paring for 255 seconds, so you need to enable multiple times until you are finished)
  10. Pair you devices. Remember to start with “mains” close to the coordinator

As all the devices are in the zigbee2mqtt overview, the repair is super fast. No need to do anything in zigbee2mqtt. All devices keep all settings and entity names in HA:-)

4 Likes