ConBee II

Installation

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

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

ConBee II / deCONZ / Phoscon App

Supported platforms

Connection

To ensure a strong radio signal, the ConBee II should preferably be connected to a USB 2.0 socket with an USB extension cable.

ConBee II USB cable
  • Prevents interference with housing and peripherals
  • Provides maximum signal range and reliability

Note

Connection problems may occur if the ConBee II is attached directly to the USB port or is located near USB 3.0 devices such as external hard drives or memory sticks.

Raspberry Pi OS

Supported Raspberry Pi models and distributions

Note

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

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

deCONZ Raspbian

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

Troubleshooting

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

Ubuntu

Supported Ubuntu versions

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.

deCONZ Ubuntu

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

Troubleshooting

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

Linux Headless

The SD card images as well as the standard installation method start automatically with graphical user interface.

Switch off graphical user interface (headless)

To switch off the graphical user interface (GUI), the following commands must be entered in the console:

  1. Stop the GUI service immediately.

      sudo systemctl disable --now deconz-gui
  2. Start the headless service now and every time the system starts.

      sudo systemctl enable --now deconz

Switch on graphical user interface (GUI)

To switch on the graphical user interface (GUI), the following commands must be entered in the console:

  1. Stop the headless service immediately.

      sudo systemctl disable --now deconz
  2. Start the GUI service now and every time the system starts.

      sudo systemctl enable --now deconz-gui

Docker

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.

macOS installation

  1. Download deCONZ.

    https://deconz.dresden-elektronik.de/macos

  2. Unzip and start deCONZ.

    Unzip the file deCONZ_macOS.zip in Downloads and start the application deCONZ.app.

Windows 11 installation

  1. Download deCONZ software

    https://deconz.dresden-elektronik.de/win

  2. Install USB driver

The drivers are installed automatically after connecting the ConBee II. If necessary, the drivers are downloaded from the Internet.

Windows 10 installation

  1. Download deCONZ software

    https://deconz.dresden-elektronik.de/win

  2. Install USB driver

The drivers are installed automatically after connecting the ConBee II. If necessary, the drivers are downloaded from the Internet.

Windows 7 installation

  1. Download deCONZ software

    https://deconz.dresden-elektronik.de/win

  2. Download and extract the driver ZIP file

    ConBee_II_USB_Driver_V1_00.zip

  3. Manual driver installation

    After plugging in the ConBee II, Windows automatically starts the search for a suitable driver.

    Win7 1
  4. Select Skip Windows Update driver software download.

    Win7 2
  5. Open Device Manager

    Enter the key combination <Win> + <Pause> and select Device Manager in the dialog that appears.

    Win7 3
  6. Right click on ConBee II and select Update driver in the context menu.

    Win7 4
  7. Select the option Search for driver software on the computer.

    Win7 5
  8. Select the directory with the extracted drivers and follow the instructions.

    Win7 6
    Win7 7
    Win7 8
    Win7 9