Skip to content

How To Install deCONZ for ConBee or RaspBee

Jump to bottom
oznu edited this page Nov 11, 2021 · 12 revisions

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, RasBee I, or RasBee II device is plugged in and you have restarted your Raspberry Pi.

Update hb-config

You will need to update hb-config before installing AdGuard Home.

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:

hb-config-home

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.

hb-config-install-deconz

Select Yes:

hb-config-install-deconz-warning

Choose the type of device you have:

hb-config-install-deconz-choose-device

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

hb-config-install-deconz-complete

ConBee Only

No further setup is required.

RasBee I Only

You will now be prompted to restart your Raspberry Pi.

RasBee 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-hue plugin to expose devices to Homebridge and HomeKit.

Example homebridge-hue config:

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

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.

See How To Connect Via VNC for instructions.

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 sensative):

deCONZ

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

sudo systemctl start deconz
Clone this wiki locally