HowTo: Zigbee - Register devices or sensors and actuators to zigbee2mqtt

So that you can get Zigbee devices for your SmartHome Of course, in order to use them, they must first be connected to your Zigbee network.

This can be implemented in various ways. The easiest way to add new devices to your Zigbee network is via cigbee2mqtt Dashboard.

Of course, the dashboard should already be set up for this. You can also find information on how to activate and use this dashboard in the article Zigbee - Administration of Zigbee2mqtt via the dashboard.

How you then connect a new Zigbee device to your Zigbee network is described in the following article.

Safety instructions

I know the following notes are always kind of annoying and seem unnecessary. Unfortunately, many people who knew "better" have lost eyes, fingers or other things due to carelessness or injured themselves. Data loss is almost negligible in comparison, but even these can be really annoying. Therefore, please take five minutes to read the safety instructions. Because even the coolest project is not worth injury or other trouble.

Affiliate links/advertising links

The links to online shops listed here are so-called affiliate links. If you click on such an affiliate link and make a purchase via this link, will receive a commission from the relevant online shop or provider. The price does not change for you. If you make your purchases via these links, you support in being able to offer other useful projects in the future. 🙂 


Helpful articles:
Before you start with this article, you should have prepared a RaspberryPi so that it can be reached via the network and controlled via SSH. In addition, zigbee2mqtt should of course already be installed.

The following articles describe what needs to be done to prepare the RaspberryPi.

In the following lists you will find all the parts you need to implement this article.

Required tool:

1xScrewdriver set  Buy at Amazon
1xSD card reader  Buy at Amazon

Required material:

1xSONOFF Zigbee 3.0 USB Dongle Plus  Buy at Amazon
1xUSB extension cable  Buy at Amazon
1x Raspberry Pi  Buy at Amazon
1x Raspberry Pi power supply  Buy at Amazon
1x Raspberry Pi case  Buy at Amazon
1x Micro SD card 64GB  Buy at Amazon

Unlock access to the Zigbee network

In order to add new devices to your Zigbee network, you must activate access to the Zigbee network.

Thanks to the zigbee2mqtt dashboard, this can be done with just one click. There is a button in the top menu bar with which access to the Zigbee network can be activated or deactivated.

View of the log tab of the zigbee2mqtt dashboard. The area marked in red contains the button that can be used to control access to the Zigbee network. The best way to follow the registration process of new Zigbee devices is to view the log tab.

If access to your Zigbee network is currently not activated, click on the button

  • Permit join (All)

to read.

So now click on the button to activate access to your Zigbee network.

As soon as access to your Zigbee network is activated, the inscription on the button changes to

  • Disable join (All) XXX

The number (here XXX) indicates how long the access is still active. Access will be deactivated again after 255 seconds at the latest. This way you avoid the access remaining activated accidentally.

Monitor the registration process of the new Zigbee device

After you have activated access to your Zigbee network, you can now register the Zigbee device. The cool thing is that you can follow this registration process live via the log output.

To do this, if you haven't already done so, open the log tab in the zigbee2mqtt dashboard.

To do this, set the “log level” to “debug” and click on the “Clear” button to hide all previous log messages.

If you haven't already done so, you should activate access to your Zigbee network now at the latest.

To do this, click on the button marked in red in the upper area of the dashboard.

At this point you should initiate the connection to the network on your Zigbee device. Most devices have a small button on the back that you have to press several times or hold down for a long time. This procedure is not uniform but should in any case be described in the device instructions.

I have also described how you register certain Zigbee devices in a few articles on You can find the articles here:

A very good list including search function is also available here:

After the Zigbee device is connected to the Zigbee network, this will be displayed in the log.

The first red underlined output in the log (type=”device joined”) indicates that a Zigbee device has joined the network.

The “interview” (type=”device_interview”) of this device then begins. Because so far the Zigbee network does not yet know what kind of device it is. All important data will now be retrieved as the registration process continues.

If Zigbee messages are received in the meantime, they will be ignored by zigbee2mqtt in order to first complete the registration process of the new Zigbee device.

As soon as all properties of the new Zigbee device have been retrieved, this will be displayed in the log. The values of the respective properties are also listed. (See areas marked red in the picture)

Towards the end of the registration process, the registration will be completed with the following...

…report confirmed.

  • Successfully configured '0xXX..XX'

This message is displayed both in the log and briefly as a popup in the lower left corner.

Disable access to Zigbee network and copy IEEE address

After you have registered all Zigbee devices, you should deactivate access to your Zigbee network again.

To do this, click on the “Disable join…” button at the top of the dashboard.

At this point you should also copy the IEEE address of your Zigbee device. This is the unique address with which your Zigbee device can be identified and under which the data is received or sent to the device.

You can find the address in the dashboard in the device overview or in the log itself. In the image below you can see the IEEE address in the hidden/masked places.

The IEEE address has the following format

  • for example: 0xbc11aceffe54a28f

You can now use the newly registered Zigbee device either via the zigbee2mqtt Dashboard control or read out or you use a SmartHome or automation software (e.g NodeRed ) to react to Zigbee events or trigger actions.

In the following category I have listed various Zigbee devices that can be controlled or read using the NodeRed code offered there.

More articles on the topic

The zigbee2mqtt dashboard is not only suitable for registering your Zigbee devices. Many other zigbee2mqtt options can also be configured. You can also find information on how to use the zigbee2mqtt dashboard in the following article.

I have summarized other articles on the subject of Zigbee and zigbee2mqtt in the following category. There you will also find articles on various Zigbee devices and how they look like NodeRed can be controlled.

External links:

Have fun with the project

I hope everything worked as described for you. If not or you have questions or suggestions please let me know in the comments. I will then add this to the article if necessary.
Ideas for new projects are always welcome. 🙂

PS Many of these projects - especially the hardware projects - cost a lot of time and money. Of course I do this because I enjoy it, but if you think it's cool that I share the information with you, I would be happy about a small donation to the coffee fund. 🙂

Buy Me a Coffee at       

Kommentar hinterlassen

Your email address will not be published. Erforderliche Felder sind mit * markiert

This site uses Akismet to reduce spam. Learn how your comment data is processed.