The deCONZ REST plugin provides a REST-API to access Zigbee 3.0 (Z30), Zigbee Home Automation (ZHA) and Zigbee Light Link (ZLL) lights, switches and sensors from Xiaomi Aqara, IKEA TRÅDFRI, Philips Hue, innr, Samsung and many more vendors.
A list of supported Zigbee devices can be found on the Supported Devices page.
For community based support with deCONZ or Phoscon, please visit the deCONZ Discord server.
The Phoscon App is a browser based web application and supports lights, sensors and switches. For more information and screenshots visit the Phoscon App Documentation.
deCONZ beta releases are scheduled roughly once per week. After 2–3 betas a stable version is released and a new beta cycle begins. The stable release is usually published between 1st — 15th of the month.
Current Beta: v2.12.0-beta
Current Stable: v2.11.5
Next Beta: v2.12.1-beta. Next Stable: v2.12.x expected in June.
You find the instructions for your platform and device on the Phoscon website:
Important: If you're updating from a previous version always make sure to create an backup in the Phoscon App and read the changelog first.
Important: The deCONZ package already contains the REST-API plugin, the development package is only needed if you wan't to modify the plugin or try the latest commits from master branch.
sudo apt install deconz-dev
Checkout the repository
git clone https://github.com/dresden-elektronik/deconz-rest-plugin.git
Checkout the latest version
cd deconz-rest-plugin git checkout -b mybranch HEAD
Compile the plugin
qmake && make -j2
Note On Raspberry Pi 1 use
qmake && make
Replace original plugin
sudo cp ../libde_rest_plugin.so /usr/share/deCONZ/plugins
The deCONZ application packages are available for the following platforms and contain the main application and the pre-compiled REST-API plugin.
To manually install a Linux .deb package enter these commands:
sudo dpkg -i <package name>.deb sudo apt-get install -f
The deCONZ package contains a systemd script, which allows deCONZ to run without a X11 server.
$ sudo systemctl enable deconz
The dresden elektronik sd-card image and default installation method autostarts deCONZ GUI. The following commands disable the deCONZ GUI service:
$ sudo systemctl disable deconz-gui $ sudo systemctl stop deconz-gui
The following libraries are used by the plugin:
The plugin is available as open source and licensed under the BSD (3-Clause) license.