In order to pair any App with Hue Emulator, you need to authorise the pairing request.

Go to your Hue Emulator Host Machine in your Browser.


Login with default credentials “Hue:Hue” and press “Activate” Button.

Retry pairing while linkbutton is active.

Next step troubleshooting:

Try deleting cached app data. On android this can be done in Settings > Apps > Hue > Storage > Clear Storage. On iOS you must reinstall the app to clear data. 

Failing that delete the cert.pem file, restart diyHue, then delete the cached app data again.

After boot, the ESP8266 will broadcast a WiFi for the first 2 minutes with the SSID set in light_name variable (default Hue .....)

Connect to this network with you phone or computer and browse to

Modern computers/phones popup automatically the configuration window. From here you can choose the SSID of the network you would like the light to connect to and enter its password.

After the light is present on your network open the official Hue application and scan for new lights. In case no lights are found, check if the nmap package is installed. Note: The app will often say no lights found but the lights will then appear a few seconds after this notification. So be patient!

Disable your WiFi temporarly and restart ESP-8266. It will reopen the configuration Access Point.

The following devices are supported by default:

  • MiLight
  • Yeelight
  • LYT8266
  • Phillips Hue
  • Ikea Tradfri

The following can be controlled with an ESP8266 or ESP32:

  • WS2812B and SK6812 smart led strips
  • Pwm RGB-CCT LEDs
  • Pwm RGBW LEDs
  • Pwm RGB LEDs
  • Pwm CCT LEDs
  • Pwm Dimming (up to 6 lights for every esp8266)
  • On/Off plugs/lights (up to 6 lights for every esp8266)
  • On/Off 433Mhz devices (multiple devices for every esp8266)

More devices are always being added!

Currently these Devices are Supported:

  • Ikea Tradfri Dimmer
  • Ikea Tradfri Switch
  • Ikea Tradfri Motionsensor
  • Hue Dimmer Switch
  • Hue Motionsensor
  • Hue Tap
  • various Xiaomi Sensors
  • […]

Hue bulbs use the zigbee radios to communicate so you either need a genuine Phillips Hue Bridge or a raspbee module.

Follow the instructions for pairing. In addition it can help to disconnect your Internet for a short period to make sure the TV performs a local Network search instead of using remote API of Phillips.

IKEA Tradfri bulbs can be controlled when paired with an IKEA hub. If you wish to use IKEA switches then you must use the Raspbee module. This will enable you to control both the IKEA lights and switches without an IKEA hub.

Not all apps for Phillips Hue work out of the box with diyHue. If you are unable to pair the app with diyHue automatically, try looking for a manual pair option in the app. If that fails then open an issue here on GitHub. We will try our best to to get your app to work but due to the lack of support for the remote API with diyHue, some apps will never work.

Google Assistant uses the remote API to find your Hue bridge. The remote API is not supported by diyHue. At the moment it looks like it never will. However, don’t despair. There is an option to get it to work. Home Assistant is software used to provide a unified hub for all your smart devices. It has support for diyHue and Google Assistant, so you can import your diyHue lights into Home Assistant and use Google Assistant to control them via Home Assistant. There are plenty of instructions on the Home Assistant website however details on Phillips Hue can be found here and details on Google Assistant here. If you need more help, ask on our Slack chat or on the Home Assistant forums.

Hue asks to update your diyLight in order to use Entertainment Function.

Restart Hue Emulator service. Restart will update the configuration and software version of your own build Lights.

sudo systemctl restart hue-emulator.service

5 thoughts on “FAQ

  1. So if I need to also have a physical hue bridge to use Hue lights what is the point in having a diyhue? I’m just curious. Not being rude.

    1. You can use Original Bulbs in diyHue in combination with a Original Hue Bridge. However, you can simply connect any Zigbee Bulb (Ikea, Philips, etc.) with a additional Zigbee Dongle, skipping the Original Bridge. In addition the Dongle also makes it possible to connect Sensors and Switches to the diyHue ecosystem. diyHue Emulator can control diyLights AND Original Hue Bulb via Bridge or Zigbee Dongle. Hope that helped.

  2. I have porblems with the generic ON OFF device. I did everything tight. I can open the light with the ip in web Browser. BUT the hue app cnt find the light. what can i do now ? i tried it many times.

    1. It does happen that it sometimes takes a bit to discover. You can start the emulator manual with sudo service hue-emulator start --debug true with additional debug output. Join our Slack channel for live and in depth support. Join Slack
      Hope that helped.

  3. Next Question:
    I use “Müller Licht – Tint” lamps (7euro from supermarket). Raspbee module is hooked up. They work good with the hue app. the Problem is when i talk to alexa, the lamps only turn red or white. when i say “alexa lamps blue” they get red too. but the app(alexa) says they are blue. what can i do? and where is the problem? in the bridge? the lamp? the raspbee module? or in the alexa app? or communication error?

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.