Technical support

We are here for you.

If you have technical questions about our products, our support team will be happy to help you.


In the frequently asked questions you will quickly find answers and further links to commissioning and trouble shootings, as well as general information.

Phoscon App and deCONZ

Is my system up to date?

The installed software version can be viewed in the Phoscon App:

  • Menu
  • Settings
  • Gateway
software version

The latest available version is described in the changelog.

The installation and update process for the respective operating system is described on the corresponding product pages, for example the ConBee II installation. If an APT repository installation on Debian based distribution is not an option under Linux, a manual installation of the Debian package is also available.

The latest versions can be found in the stable download folder of the respective operating systems:

Besides that there is also the beta download folder. Beta versions are made available in shorter intervals, in which new functions can be tested or certain problems can be solved with specific bug fixes.

Why are new Phoscon App features not available?

The Phoscon App can be opened in several ways. Depending on the method, different content can be displayed.

  • via the local IP address of the gateway: the range of functions of the locally installed deCONZ version is available.
  • via the website The latest range of functions is available. (An internet connection of the gateway is necessary.)
  • via the native Smartphone App: the latest range of functions is available.

Under certain circumstances it might be necessary to delete the app data in the browser cache to force an update.

Can I use the Phoscon App with my smartphone?

The Phoscon App can be downloaded as a standalone smartphone app and also opened in the smartphone’s web browser. The range of functions is identical.

ConBee and RaspBee

What is the difference between ConBee and ConBee II?

Both devices offer the same Zigbee functionality. The ConBee II has a smaller housing.

ConBee and ConBee II are actively maintained and supported by deCONZ control software.

How can the firmware of ConBee II, ConBee III or RaspBee II be updated?

The firmware must be updated manually via the command line as described in the wiki article Update deCONZ manually and Youtube-clip.

What is the range of ConBee, ConBee II, ConBee III and RaspBee?

The range in buildings is up to 30 m and in free field of sight up to 200 m. Due the power amplifier it is possible to bridge 2-3 rooms or floors depending on the building conditions.

Devices further away are connected through the Zigbee mesh network. In this network, all permanently powered Zigbee devices, such as lights and sockets, act as repeaters and can relay the signal.

The average range of IKEA, OSRAM and Philips Zigbee devices is approximately 5-7 m. With appropriate distribution, the mesh network can be spread over entire floors or the building.

What is the maximum number of devices that can be connected?

ConBee II and RaspBee II support up to 512 network participants in mixed networks - with lights and other devices.


How to reset the FLS to factory settings?

The FLS can be reset to factory settings using the following reset sequence:

Resetsequenz FLS

  1. Switch the FLS off and on again 4 times for 5 seconds each.
  2. When the light starts flashing, wait about 10 seconds for it to stop flashing.
  3. Switch the FLS off and on 2x for approx. 5 seconds each.

    The light is reset to factory settings when it flashes briefly.

The following YouTube video shows the reset sequence.

How to reset a Philips Hue light to factory settings?
(Also applies to most lights from other manufacturers)

The simplest method is to reset it using the Philips Hue Dimmer Switch remote control.

  1. Start search for lights in the Phoscon App
  2. Turn the Philips Hue light off/on once
  3. Hold the remote control close to the light and press and hold the the two outer buttons for about 10 seconds until the light illuminates.
  4. The light should now be paired within 1 minute by the Phoscon App

Alternative: If the light is still paired to the Philips Hue Bridge, it can also be deleted in the Philips Hue App. Afterwards the light resets to factory settings and can be paired by the Phoscon app.

How does a FLS behave when switched off and on again?

If an RGB/W LED-Stripe is connected, the last set color will be restored. If the brightness was less than 80 %, it will be set to 30 %.

Otherwise the last set value is restored again. The last setting must have existed at least 20 seconds before switching off in order to be recalled.

How can Friends of Hue switches be paired to the network?


A list of all compatible Friends of Hue switches can be found at Compatibility list →

  1. Check the current Zigbee channel of the gateway in the Phoscon App.

    • Menu
    • Settings
    • Gateway
    • Advanced
    Find Zigbee channel in settings
  2. Go to the switch overview page.

    • Menu
    • Devices
    • Switches
    Add new switch
  3. Select than

  4. Press the button matching the Zigbee channel on the switch for 10 seconds.

    • Zigbee channel 15 → button 1
    • Zigbee channel 20 → button 2
    • Zigbee channel 11 → button 3
    • Zigbee channel 25 → button 4
    Friends of Hue key mapping
  5. Important: Complete commissioning by briefly pressing buttons 2 and 3 simultaneously.

    Friends of Hue complete commissioning
  6. Once the switch has been paired to the network, it can be easily configured via the switch editor of the Phoscon App. Phoscon App documentation →

    Friends of Hue switch in switch editor
How to update LEDVANCE devices?

The following steps describe the OTA update of LEDVANCE devices. In this example the smart plug is updated.


This guide requires the deCONZ GUI with at least version 2.5.71. The headless deCONZ version is not supported yet.

  1. Select the standard OTAU plugin via the menu bar in deCONZ.

    • Menu
    • Plugins
    • STD OTAU Plugin

    Screenshot: deCONZ Menu Plugins

  2. Switch to the STD OTAU Plugin tab.

    Screenshot: deCONZ STD OTAU Plugin tab

  3. Select the device in the list.

    Screenshot: deCONZ STD OTAU Plugin

    1. Check the MAC address of the device that is to be updated.

    2. Select the appropriate device from the list using the MAC address.

  4. Download the OTAU file.

    Screenshot: LEDVANCE download page

    Remember the image type and enter it in the corresponding field on the LEDVANCE page. Download the OTAU file via the button Latest.

  5. Run the OTA update.

    Screenshot: deCONZ OTA update

    1. Select the device entry in the list.
    2. Select the OTAU file.
    3. Start the OTAU via Update button.

      Screenshot: Fortschritt des Downloads

    The process can take up to 5–10 minutes. After completion, the device will restart itself.

    Screenshot: download done

Is my Zigbee device compatible?

The compatibility of devices is divided into several compatibility lists, as a distinction is made between support in the REST API and the Phoscon App.

The Compatibility list on the Phoscon website mainly lists devices that are supported in the Phoscon app. In the future, the scope of support will be specified more precisely, e. g. whether a wizard is available for connecting and which functions are possible to use with the device.

The more comprehensive automatically created DDF compatibility list contains the devices that can be used via the REST API and thus via the numerous Home Automation Systems. It will gradually replace the manually maintained list.

If the device you are looking for is not listed, it is worth taking a look at the posts on the current status of the integration in the GitHub Issues.

If it is about a recently released device that is not yet mentioned, the integration can be requested by providing deCONZ screenshots as described in the Wiki on GitHub.

Another recommendation is the Blakadder Compatibility list which is maintained by the community. This provides an extensive overview of the devices supported by the deCONZ REST API.

For home automation systems that do not use deCONZ and therefore do not use the REST API and the Phoscon app, their own compatibility lists apply, such as for Zigbee2MQTT.

How can devices from dresden elektronik be updated?

Connected devices from dresden elektronik can be updated wirelessly via deCONZ. This process is done manually.

The necessary firmware files are product specific and must be stored on the deCONZ system.

  1. Open deCONZ and under Plugins open the OTA Update menu.
  2. Mark the device to be updated in the list.
  3. Open the previously saved OTAU File and start the process with the Update button.

The start of the update process can sometimes take a long time, since the devices only ask for updates at regular intervals. This can be forced by power cycling the device to speed up the process start.

The entire update process can take 10 to 30 minutes. During this time, the device to be updated must not be switched off. After a successful update, the device restarts itself.


IKEA TRÅDFRI lights cannot be paired.

To be able to pair an IKEA TRÅDFRI light, it must be set to factory settings. The following steps and the timing of the reset sequence must be strictly followed.

  1. Start search for lights in the Phoscon App
  2. Switch light off/on 6 times quickly (reset sequence)
  3. The light flickers briefly, then switch it off/on once again
  4. The light should now be paired within 1 minute by the Phoscon App

In this Youtube video the execution of the reset sequence is shown.

Troubleshooting for ConBee II with Linux

The following steps guide you to check and fix problems of a deCONZ installation and the ConBee II. We recommend to follow the steps one after the other.

  1. Check USB connection and mitigate USB 3.0 problems.

    Drawing: ConBee II USB extension cable

    The ConBee II should preferably be connected to a USB 2.0 socket with an USB extension cable. 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.

  2. Check that the communication between ConBee II and deCONZ works.

    Screenshot: Firmware not connected

    If the Phoscon App in the Gateway Settings displays not connected instead of the current firmware version, it’s an indication that the communication between deCONZ and ConBee II could not be established. In this case the next steps should be performed to re-establish the connection.

  3. Check that the current deCONZ version is installed.

    This ensures that already fixed problems of earlier versions do not occur. To install the latest version, all steps must be performed at for the platform used.

  4. Check that a connected ConBee II is registered in the system.

    $ lsusb
    Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
    Bus 001 Device 006: ID 8087:0a2b Intel Corp.
    Bus 001 Device 078: ID 1cf1:0030 Dresden Elektronik

    If the ConBee II has been registered in the system, the manufacturer and product code 1cf1:0030 will be shown for dresden elektronik and the ConBee II.

    If the ConBee II does not appear in the list and deCONZ is running in a virtual machine or a docker container, the USB device needs to be added to the virtual environment.

    In the case of Docker, this happens automatically when the container is started according to the installation instructions:

  5. Check that the serial interface is available.

    $ ls -l /dev/ttyACM*
    crw-rw---- 1 root dialout 166, 0 27. Jun 11:39 /dev/ttyACM0

    Depending on whether other USB devices are used, the device file of the ConBee II is created with a consecutive number as /dev/ttyACM0 or /dev/ttyACM1.

    Important: In order to have read and write access to the device, the user must be in the dialout group as described in the installation instructions.

  6. Check that the ConBee II firmware is installed and up to date.

    Note: If a previous update has failed, the firmware will be reinstalled.

    • Close deCONZ if it’s running
    • Unplug the ConBee II and wait 10 seconds
    • Connect the ConBee II again and wait 10 seconds
    • Install the latest firmware

      sudo GCFFlasher_internal -d /dev/ttyACM0 -t 60 \
      -f /usr/share/deCONZ/firmware/deCONZ_ConBeeII_0x26490700.bin.GCF


Lots of discussion about deCONZ in connection with other home automation systems as well as suggestions for new ideas also takes place in the community.


I have one more question… The answer was not yet there?
Our support will be happy to help you.