home-assistant.io/source/_components/light.hue.markdown
Fares Rihani 36c60ffd19 Consolidated spelling fixes. ref #1052 (#1132)
* Consolidated spelling fixes. ref #1052
2016-10-05 10:17:36 +02:00

1.7 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 the discovery component.

Once discovered, locate "configurator.philips_hue" in the entities list ( < > ) and add it to configuration.yaml. Restart home assistant so that it 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 can be removed from 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 light component directly, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
light:
  platform: hue
  host: DEVICE_IP_ADDRESS
  allow_unreachable: true
  filename: my_hue_hub_token.conf

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.