Raspbian

Supported Raspberry Pi models and distributions

• Raspberry Pi 1, 2B, 3B, 3B+ und 4B
• Raspbian Jessie
• Raspbian Stretch
• Raspbian Buster
• Raspbian Bullseye

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 -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

   Stable

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

   Beta (alternative)

   sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
               $(lsb_release -cs)-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

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

Installation without deCONZ-GUI (headless)

The setup without graphical user interface (headless) is described in the deCONZ GitHub repository.

Update via repository

1. Update APT package list

    sudo apt update

2. Update deCONZ

    sudo apt install deconz

Troubleshooting

If problems occur during the installation, the Support section answers frequently asked questions (FAQ) and provides further assistance.

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 -O - http://phoscon.de/apt/deconz.pub.key | \
              sudo apt-key add -

3. Configure the APT repository for deCONZ

   Stable

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

   Beta (alternative)

   sudo sh -c "echo 'deb [arch=amd64] http://phoscon.de/apt/deconz \
               $(lsb_release -cs)-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.

Auto start of the deCONZ GUI (optional)

1. Open the Startup Application Preferences via the application menu

    gnome-session-properties

2. Add a new entry with the following commandline:

    deCONZ --http-port=80 --auto-connect=1

   

Troubleshooting

If problems occur during the installation, the Support section answers frequently asked questions (FAQ) and provides further assistance.

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.