ConBee
Installation
Zur Konfiguration, Steuerung und Darstellung von Zigbee Netzwerken mit dem ConBee Zigbee USB-Gateway, wird die Software deCONZ verwendet.
Die folgenden Abschnitte beschreiben die Installationsschritte von deCONZ für verschiedene Plattformen.

Unterstützte Plattformen
Anschließen
Für den optimalen Betrieb wird die Nutzung eines USB-Verlängerungskabels empfohlen.
- Verhindert Interferenzen mit Gehäuse und Peripherie
- maximale Signalreichweite für zuverlässige Steuerung
Raspbian
Unterstützte Raspberry Pi Modelle und Distributionen
- Raspberry Pi 1, 2B, 3B, 3B+ und 4B
- Raspbian Jessie
- Raspbian Stretch
- Raspbian Buster
Hinweis
Die folgenden Schritte beschreiben die manuelle Installation von deCONZ. Alternativ kann ein vorinstalliertes SD-Karten Image verwendet werden.
Installation
USB-Zugriffsrechte für Nutzer setzen
sudo gpasswd -a $USER dialout
Hinweis: Die Zugriffsrechte werden erst nach dem Aus- und Einloggen bzw. nach einem Neustart aktiv.
Phoscon Public-Key importieren
wget -O - http://phoscon.de/apt/deconz.pub.key | \ sudo apt-key add -
APT-Repository für deCONZ konfigurieren
Stable
sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \ $(lsb_release -cs) main' > \ /etc/apt/sources.list.d/deconz.list"
Beta (Alternativ)
sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \ $(lsb_release -cs)-beta main' > \ /etc/apt/sources.list.d/deconz.list"
APT-Paketliste aktualisieren
sudo apt update
deCONZ installieren
sudo apt install deconz
Nach der Installation kann deCONZ über das Applikationsmenü gestartet werden.
Menu > Programming > deCONZ

Nun können die ersten Zigbee Geräte über die Phoscon App angelernt werden. Weitere Informationen hierzu gibt es in der Phoscon App Dokumentation.
Ubuntu
Unterstützte Versionen
- 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
USB-Zugriffsrechte für Nutzer setzen
sudo gpasswd -a $USER dialout
Hinweis: Die Zugriffsrechte werden erst nach dem Aus- und Einloggen bzw. nach einem Neustart aktiv.
Phoscon Public-Key importieren
wget -O - http://phoscon.de/apt/deconz.pub.key | \ sudo apt-key add -
APT-Repository für deCONZ konfigurieren
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 (Alternativ)
sudo sh -c "echo 'deb [arch=amd64] http://phoscon.de/apt/deconz \ $(lsb_release -cs)-beta main' > \ /etc/apt/sources.list.d/deconz.list"
APT-Paketliste aktualisieren
sudo apt update
deCONZ installieren
sudo apt install deconz
Nach der Installation kann deCONZ über das Applikationsmenü gestartet werden.

Nun können die ersten Zigbee Geräte über die Phoscon App angelernt werden. Weitere Informationen hierzu gibt es in der Phoscon App Dokumentation.
Docker
Unterstützte Hostsysteme
- Linux x86_64/amd64
- Linux armv7 (z. B. Raspberry Pi)
- Linux arm64
Um die Steuersoftware deCONZ in einem Docker Container zu betreiben, empfehlen wir das von der Community gepflegte Docker Image marthoc/deconz. Dieses ist auf amd64, arm64 und armhf Plattformen lauffähig.
https://hub.docker.com/r/
Installation
Im Folgendem wird beschrieben wie der deCONZ Container auf einem Linux Hostsystem gestartet wird.
USB-Zugriffsrechte für Nutzer setzen
sudo gpasswd -a $USER dialout
Hinweis: Die Zugriffsrechte werden erst nach dem Aus- und Einloggen bzw. nach einem Neustart aktiv.
Verzeichnis für persistente Konfiguration erstellen
mkdir -p ~/.local/share/dresden-elektronik/deCONZ
deCONZ Docker Container starten
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
Mit dieser Konfiguration läuft deCONZ im Docker Container auf Port 80.
Nun können die ersten Zigbee Geräte über die Phoscon App angelernt werden. Weitere Informationen hierzu gibt es in der Phoscon App Dokumentation.
Eine Beschreibung aller verfügbaren Parameter, sowie die Verwendung von Docker-Compose und VNC-Zugriff auf die deCONZ GUI ist in der Container Dokumentation zu finden.
Windows 10 Installation
deCONZ Software herunterladen
USB-Treiber installieren
Die Installation der Treiber erfolgt nach dem Anstecken des ConBee automatisch. Dabei werden ggf. die Treiber aus dem Internet heruntergeladen.
Windows 7 Installation
deCONZ Software herunterladen
USB-Treiber installieren
Die Installation der Treiber erfolgt nach dem Anstecken des ConBee automatisch. Dabei werden ggf. die Treiber aus dem Internet heruntergeladen.