ConBee

Raspbian

Supported Raspberry Pi models and distributions

• Raspberry Pi (all models, except Pico)
• Raspberry Pi OS

Installation

1. Set user USB access rights

    sudo gpasswd -a $USER dialout

   Note: Changes to access rights only become active after logging out and in or after a restart.

2. Import Phoscon public key

   wget -qO- https://phoscon.de/apt/deconz.pub.key | gpg --dearmor | \
             sudo tee /etc/apt/trusted.gpg.d/deconz-keyring.gpg >/dev/null

3. Configure the APT repository for deCONZ

   Stable

   sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
               generic main' > \
               /etc/apt/sources.list.d/deconz.list"

   Beta (alternative)

   sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
               generic-beta main' > \
               /etc/apt/sources.list.d/deconz.list"

4. Update APT package list

    sudo apt update

5. Install deCONZ

    sudo apt install deconz

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

Menu > Programming > deCONZ

Ubuntu

Supported Ubuntu versions

• Ubuntu 16.04 LTS 64-Bit PC (AMD64)
• Ubuntu 18.04 LTS 64-Bit PC (AMD64)
• Ubuntu 20.04 LTS 64-Bit PC (AMD64)

Installation

1. Set user USB access rights

    sudo gpasswd -a $USER dialout

   Note: Changes to access rights only become active after logging out and in or after a restart.

2. Import Phoscon public key

   wget -qO- https://phoscon.de/apt/deconz.pub.key | gpg --dearmor | \
             sudo tee /etc/apt/trusted.gpg.d/deconz-keyring.gpg >/dev/null

3. Configure the APT repository for deCONZ

   Stable

   sudo sh -c "echo 'deb [arch=amd64] http://phoscon.de/apt/deconz \
               generic main' > \
               /etc/apt/sources.list.d/deconz.list"

   Beta (alternative)

   sudo sh -c "echo 'deb [arch=amd64] http://phoscon.de/apt/deconz \
               generic-beta main' > \
               /etc/apt/sources.list.d/deconz.list"

4. Update APT package list

    sudo apt update

5. Install deCONZ

    sudo apt install deconz

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

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

Docker

Supported host systems

• Linux x86_64/amd64
• Linux armv7 (e.g. Raspberry Pi)
• Linux arm64

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.

https://hub.docker.com/r/marthoc/deconz

Installation

The following steps describe how to start the deCONZ container on a Linux host system.

1. Set user USB access rights

    sudo gpasswd -a $USER dialout

   Note: Changes to access rights only become active after logging out and in or after a restart.

2. Create directory for persistent configuration

    mkdir -p ~/.local/share/dresden-elektronik/deCONZ

3. Start deCONZ Docker container

    docker run -d \
      --name=deconz \
      --net=host \
      --restart=always \
      -v /etc/localtime:/etc/localtime:ro \
      -v ~/.local/share/dresden-elektronik/deCONZ:/root/.local/share/dresden-elektronik/deCONZ \
      --device=/dev/ttyUSB0 \
      marthoc/deconz

With this configuration deCONZ runs in a Docker container on port 80.

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

A description of all available parameters as well as the use of Docker-Compose and VNC to access the deCONZ GUI can be found in the Container Documentation.