ConBee II Zigbee USB Stick Instruction Manual

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.

Supported platforms

Raspberry Pi OS	Ubuntu	Docker	macOS
Windows 11	Windows 10	Windows 7

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.

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

Raspberry Pi (all models, except Pico)

Raspberry Pi OS

Note

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

Installation

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.

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

Update APT package list
sudo apt update
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.

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

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

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”
Update APT package list
sudo apt update

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)

Open the Startup Application Preferences via the application menu
gnome-session-properties
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.

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:

Stop the GUI service immediately.
sudo systemctl disable –now deconz-gui
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:

Stop the headless service immediately.
sudo systemctl disable –now deconz
Start the GUI service now and every time the system starts.
sudo systemctl enable –now deconz-gui

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.

macOS installation

Download deCONZ.
https://deconz.dresden-elektronik.de/macos
Unzip and start deCONZ.
Unzip the file “deCONZ_macOS.zip” in “Downloads” and start the application “deCONZ.app”.

Windows 11 installation

Download deCONZ software
https://deconz.dresden-elektronik.de/win

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

Download deCONZ software
https://deconz.dresden-elektronik.de/win
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

Download deCONZ software
https://deconz.dresden-elektronik.de/win
Download and extract the driver ZIP file
ConBee_II_USB_Driver_V1_00.zip
Manual driver installation
After plugging in the ConBee II, Windows automatically starts the search for a suitable driver.

Select “Skip Windows Update driver software download”.
Open Device Manager
Enter the key combination <Win> + <Pause> and select “Device Manager” in the dialog that appears.
Right click on “ConBee II” and select “Update driver” in the context menu.