Skip to content

Installation of deCONZ

Kosta edited this page Dec 18, 2018 · 8 revisions

Here is a step by step solution to install the deCONZ api.

First download the software

  • for raspberry devices:
pi@raspberry:~ $ wget http://www.dresden-elektronik.de/rpi/deconz/deconz-latest.deb
  • for amd64 devices:
pi@raspberry:~ $ wget https://www.dresden-elektronik.de/deconz/ubuntu/beta/deconz-2.05.52-qt5.deb

for amd64 you need to check if a newer version is available. -> https://www.dresden-elektronik.de/deconz/ubuntu/beta/

run the installer

pi@raspberry:~ $ sudo dpkg -i deconz-latest.deb 
or
pi@raspberry:~ $ sudo dpkg -i deconz-2.05.52-qt5.deb

install dependencys

pi@raspberry:~ $ sudo apt update 
pi@raspberry:~ $ sudo apt install -f

Remote login to the GUI

To access the GUI you must use a X11 Tunnel. Use the -X option in your ssh connection to the raspberry.

ssh -X pi@raspberry

check if your display is ready -> you should see something like this

pi@raspberry:~ $ echo $DISPLAY
localhost:11.0

MAC users must install XQuartz on OSX

http://xquartz.macosforge.org/landing/

logoff & login to your mac and use the -X option in your ssh connection

Windows users must install xming as x-server additional to putty

https://sourceforge.net/projects/xming/

now we can start the gui as root

pi@raspberry:~ $ sudo cp .Xauthority /root && sudo deCONZ

Important note for GUI access

The GUI and the service cannot run together. So if you want to use the GUI for debugging purposes, disable the deconz service and run the GUI. And the GUI must be run as root user.

pi@raspberry:~ $ sudo systemctl stop deconz
pi@raspberry:~ $ sudo cp .Xauthority /root && sudo deCONZ

Headless support

Enable the service and disable the gui autostart.

pi@raspberry:~ $ sudo systemctl enable deconz
Created symlink /etc/systemd/system/multi-user.target.wants/deconz.service → /lib/systemd/system/deconz.service.

pi@raspberry:~ $ sudo systemctl disable deconz-gui
pi@raspberry:~ $ sudo systemctl stop deconz-gui
pi@raspberry:~ $ sudo systemctl start deconz

Change default config

open the systemd file and change the option "ExecStart="

pi@raspberry:~ $ sudo vi /lib/systemd/system/deconz.service

ExecStart=/usr/bin/deCONZ -platform minimal --http-port=80 --ws-port=8080 --dev=/dev/ttyUSB0

  • http port
  • websocket port
  • from version V2_05_31 the device statement can be used to define the usb/serial device.

after a config change you must reload the config

pi@raspberry:~ $ sudo systemctl daemon-reload 
pi@raspberry:~ $ sudo systemctl restart deconz

Update the software

To update the software, simply restart the installer with the latest downloaded package.

  • for raspberry devices:
pi@raspberry:~ $ wget http://www.dresden-elektronik.de/rpi/deconz/deconz-latest.deb
  • for amd64 devices: wget
pi@raspberry:~ $ wget https://www.dresden-elektronik.de/deconz/ubuntu/beta/deconz-dev-2.05.46.deb

for amd64 you need to check if a newer version is available. -> https://www.dresden-elektronik.de/deconz/ubuntu/beta/

pi@raspberry:~ $ sudo dpkg -i deconz-latest.deb 
or
pi@raspberry:~ $ sudo dpkg -i econz-dev-2.05.46.deb
You can’t perform that action at this time.