The deCONZ application is a tool to configure, control and monitor Zigbee networks with the ConBee.

The following sections describe the installation steps of deCONZ for various platforms.

RaspBee / deCONZ / Phoscon App

Supported platforms


The RaspBee must be placed on the Raspberry Pi header as follows:

RaspBee placed on Raspberry Pi Header

Important: The RaspBee must not be placed in an offset position, as this will damage the module!

RaspBee placed on Raspberry Pi Header perspective


Supported Raspberry Pi models and distributions


The following steps describe the manual installation of deCONZ. Alternatively a preinstalled SD-card image can be used.


  1. Configure user access rights of the serial interface

     sudo raspi-config

    Interface Options → Serial Port

    • Would you like a login shell accessible over serial? → No
    • Would you like the serial port hardware to be enabled? → Yes

    Note: Changes to access rights only become active after a restart.

  2. Import Phoscon public key

     wget -O - http://phoscon.de/apt/deconz.pub.key | \
               sudo apt-key add -

    Note: The apt-key deprecation warning is uncritical and can be ignored.

  3. Configure the APT repository for deCONZ


    sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
                $(lsb_release -cs) main' > \

    Beta (alternative)

    sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
                $(lsb_release -cs)-beta main' > \
  4. Update APT package list

     sudo apt update
  5. Install deCONZ

     sudo apt install deconz
  6. Update WiringPi (only needed for Raspberry Pi 4B)

     cd /tmp
     wget https://project-downloads.drogon.net/wiringpi-latest.deb
     sudo dpkg -i wiringpi-latest.deb

After the installation deCONZ can be started via the application menu.

Menu > Programming > deCONZ

deCONZ Raspbian Screenshot

Now the first Zigbee devices can be paired via the Phoscon App. Further information can be found in the Phoscon App documentation.


Supported host systems

To run deCONZ in a Docker container, we recommend the Docker image deconz-community/deconz-docker, which is maintained by the community.

The installation steps are described on https://github.com/deconz-community/deconz-docker.