
The only setting that has to be adjusted is the path to your Zigbee adapter. You can customize the containers name if you so wish (I see no reason to do so), and I recommend leaving the network type set to bridge mode.

Searching for Zigbee2MQTT in Unraid’s Community Applications should bring up the correct Docker container template and nothing else.

You could set up a virtual machine and host it natively, but Docker does speed things up and the configuration is much easier. It is provided by the Selfhosters Unraid Discord Repository and is the preferred way of installing Zigbee2MQTT on Unraid. There is a preconfigured template for Zigbee2MQTT available in the Unraid Community Applications. While there is another way of mapping the adapter, I don’t see any advantage of choosing that option over the one described above. I recommend mapping the adapter using this method, especially if you have multiple USB devices attached to your Unraid server. Copy it and paste it into a note as you will need it during the installation of Zigbee2MQTT on Unraid. The path you will need is highlighted in blue. That way I can be sure to have the right path. As you can see, I use Slaesh’s CC2652RB stick and the device is named accordingly. The answer to this command should read similar to the one shown below. Open the terminal by clicking on this icon ls -l /dev/serial/by-id If you’re struggling with range, buy yourself more Zigbee lights or smart outlets and place them around your place. Almost any mains-powered device is also a router which will relay messages from other devices. If you want to increase the range and stability of your Zigbee network, buy more routers. I also recommend you take a look at this article and set your Zigbee and Wi-Fi channels accordingly. Wi-Fi and Zigbee both operate in the 2.4 GHz spectrum and interference between the two is a common occurrence (with Zigbee usually losing out). Secondly, don’t place the adapter anywhere near a Wi-Fi router or access point. If you were to plug the adapter in to one of the onboard USB ports, the antenna can suffer from interference stemming from radio signals and electrical components of the Unraid server. Firstly, get yourself a USB female to male extension cable and create some distance between the Zigbee adapter and the Unraid server. There are a few rules I recommend you follow when setting up Zigbee2MQTT on Unraid (and any other system for that matter) and your Zigbee network in general. Despite not being recommended, the CC2531 is still supported alongside a handful of other adapters. The CC2531 is no longer recommend by the applications author as it supports fewer simultaneously connected devices when compared to newer adapters, and it only has a PCB antenna which doesn’t have the best range. However, you need a CC debugger and CC2531 downloader cable to accompany it, which does push the price up. The Texas Instruments CC2531 is most likely the cheapest adapter and was, until recently, the recommended option.
