home-assistant.io/source/_components/light.hue.markdown
2016-10-12 22:18:07 +02:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_iot_class, featured
layout title description date sidebar comments sharing footer logo ha_category ha_iot_class featured
page Philips Hue Instructions how to setup Philips Hue within Home Assistant. 2015-03-23 20:09 true false true true philips_hue.png Light Local Polling true

Philips Hue support is integrated into Home Assistant as a light platform. The preferred way to setup the Philips Hue platform is by enabling the discovery component.

Once discovered, if you have a custom default view, locate configurator.philips_hue in the entities list ( < > ) and add it to a group in configuration.yaml. Restart Home Assistant so that the configurator is visible in the Home Assistant dashboard. Once Home Assistant is restarted, locate and click on configurator.philips_hue to bring up the initiation dialog. This will prompt you to press the Hue button to register the Hue hub in home assistant. Once complete, the configurator entity isn't needed anymore and can be removed from any visible group in configuration.yaml.

Restarting Home Assistant once more should result in the Hue lights listed as "light" entities. Add these light entities to configuration.yaml and restart home assistant once more to complete the installation.

If you want to enable the component without relying on the discovery component, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
light:
  platform: hue
  host: DEVICE_IP_ADDRESS

Configuration variables:

  • host (Required): IP address of the device, eg. 192.168.1.10.
  • allow_unreachable (Optional): This will allow unreachable bulbs to report their state correctly. By default name from the device is used.
  • filename (Optional): Make this unique if specifying multiple Hue hubs.