---
title: Osramlightify
description: Instructions on how to integrate Osram Lightify into Home Assistant.
ha_category:
  - Light
ha_release: 0.21
ha_iot_class: Local Polling
ha_domain: osramlightify
ha_platforms:
  - light
ha_integration_type: integration
---

The `osramlightify` platform allows you to integrate your [Osram Lightify](https://www.osram.com/cb/lightify/index.jsp) into Home Assistant.

```yaml
# Example configuration.yaml entry
light:
  - platform: osramlightify
    host: IP_ADDRESS
```

{% configuration %}
host:
  description: "IP address of the Osram Lightify bridge, e.g., `192.168.1.50`."
  required: true
  type: string
allow_lightify_nodes:
  description: (true/false) If `true` then import individual lights, if `false` then skip them.
  required: false
  default: true
  type: boolean
allow_lightify_sensors:
  description: (true/false) If `true` then import contact and motion sensors, if `false` then skip them. Takes effect only if `allow_lightify_nodes` is `true`.
  required: false
  default: true
  type: boolean
allow_lightify_switches:
  description: (true/false) If `true` then import switches, if `false` then skip them. Takes effect only if `allow_lightify_nodes` is `true`.
  required: false
  default: true
  type: boolean
allow_lightify_groups:
  description: (true/false) If `true` then import groups, if `false` then skip them.
  required: false
  default: true
  type: boolean
interval_lightify_status:
  description: Minimum interval in seconds between querying light status (for both individual lights and groups).
  required: false
  default: 5
  type: integer
interval_lightify_conf:
  description: Minimum interval in seconds between querying groups and scenes configuration.
  required: false
  default: 3600
  type: integer
{% endconfiguration %}

At the moment there is not much functionality for Osram Lightify switches and sensors.
The only thing that you can do out of the box is to track whether they are available or not.
Also for sensors a list of raw values is exposed as `sensor_values` attribute, and you can use them
in automations, if you know what particular values mean for your sensor.

It is suggested to make [scan_interval](/docs/configuration/platform_options/#scan-interval)
(30 seconds by default) less or equal to `interval_lightify_status`, otherwise the latter won't work
as expected. Shorter `scan_interval` may improve synchronization speed between individual lights and
groups. For example, if you turn on a group, all its lights may be updated to `on` immediately,
without querying the bridge.

Please note that to update all light statuses, only one query to the bridge is actually needed.

If a group has associated scenes, they will be imported as light effects and visible in `Effect`
dropdown on UI. You can apply a scene by clicking an item from the dropdown or by calling
`light.turn_on` service:

```yaml
  - service: light.turn_on
    target:
      entity_id: light.bedroom
    data:
      effect: Romance
```