How To Install deCONZ for ConBee or RaspBee

If you have a Raspberry Pi running the Homebridge Raspberry Pi image you can easily install deCONZ / Phoscon using the hb-config command. This guide will show you how to install deCONZ in a way that does not conflict with any existing Homebridge services.

Ensure your ConBee I, ConBee II, RaspBee I, or RaspBee II device is plugged in and you have restarted your Raspberry Pi.

Update hb-config

You will need to update hb-config before installing deCONZ.

To update hb-config run:

sudo hb-config

Then select the Update option.

Install deCONZ

To install deCONZ run:

sudo hb-config

This will bring up this screen, select Extra Packages:

Select deCONZ / Phoscon:

If you don't see the deCONZ / Phoscon option you may need to update hb-config. You can do this by selecting Update on the previous screen.

Select Yes:

Choose the type of device you have:

deCONZ will now be installed and any device-specific configuration done. Once complete you will see the following screen:

ConBee Only

No further setup is required.

RaspBee I Only

You will now be prompted to restart your Raspberry Pi.

RaspBee II Only

You will now be prompted to restart your Raspberry Pi. Once your device has restarted you will need to run the following commands to sync the RTC module:

sudo hwclock --systohc
sudo hwclock --verbose

See https://phoscon.de/en/raspbee2/install#raspbian for further information.

Connect to Phoscon

You can now configure deCONZ using the Phoscon web app by going to http://homebridge.local:4530 or http://phoscon.de/pwa/.

Note that the default Phoscon port is 4530.

Connect Homebridge

You can now use the homebridge-deconz plugin to expose devices to Homebridge and HomeKit. It replaces homebridge-hue for deCONZ gateways.

Example homebridge-deconz config:

{
    "name": "deCONZ",
    "hosts": [
        "127.0.0.1:4530"
    ],
    "platform": "deCONZ"
}

See the homebridge-deconz wiki for more details.

Optional: Access deCONZ GUI

If you need to access the deCONZ GUI to perform more advanced options that are not available via Phoscon, you will need to enable and connect to your Raspberry Pi using VNC.

Note: VNC Server support was removed from the Homebridge Raspberry Pi Image in December 2025, so these steps only work on older images. See How To Connect Via VNC for more information.

Once connected via VNC, open a terminal window (inside the VNC session) and stop the background deCONZ service by running:

sudo systemctl stop deconz

Now you can launch the deCONZ GUI by running (this is case sensitive):

deCONZ

Once you have finished, make sure you start the background deCONZ service again:

sudo systemctl start deconz