This guide is based on CUBE OS. For more details, please visit: CUBE OS
Preparation #
eWeLink CUBE OS is a free, open, self-hosted local software system designed to upgrade the smart devices already in your home.
Before getting started, ensure that CUBE OS is installed. If not yet installed, please follow the CUBE OS Installation Guide. When adding Zigbee devices in the CUBE OS system, you need to insert the Zigbee Dongle (as an essential Zigbee gateway) into the host running CUBE OS.
Step 1: Initialize Zigbee #
1、After plugging in your Zigbee adapter. CUBE shows a pop-up, such as when the adapter is detected.

2、Click.Start Setup
If the Dongle already runs a supported Zigbee firmware version, CUBE completes setup automatically. If the firmware version is not supported, CUBE provides one-click flashing to the recommended stable version.

Once the adapter has completed its firmware upgrade and configuration, you can now add Zigbee devices.
3、Submit the configuration by clicking confirm. If successful, you can add Zigbee devices. In case of a failure, check the specific error message.
Note: Since a Zigbee network can only have one adapter configuration, multiple setups are not supported. If a configured adapter is removed and then reinserted, it will attempt to automatically restore itself without needing reconfiguration.
Step 2: Add Zigbee Devices #
1、After configuration, on the add device page, click "Start Pairing" to add Zigbee devices in pairing mode automatically.
Note:If your Zigbee device is not found, ensure the device is in network configuration mode and check for excessive surrounding radio interference.

2、Discovered Zigbee devices will then be added to your CUBE OS, ready to assign a room or edit the name.

NOTE:The total number of Zigbee devices that can be added is limited, depending on the adapter's hardware and firmware.
In certain cases, you need to add extra router devices (e.g. smart plugs, lights, signal repeaters) to add more battery-powered devices like sensors.