home-assistant.io/source/_integrations/device_sun_light_trigger.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_quality_scale	ha_domain	ha_integration_type
Presence-based Lights	Instructions on how to automate your lights with Home Assistant.	Automation Light Presence Detection	Calculated	pre 0.7	internal	device_sun_light_trigger	integration

Home Assistant has a built-in integration called device_sun_light_trigger to help you automate your lights. The integration will:

• Fade in the lights when the sun is setting and there are people home
• Turn on the lights when people get home after the sun has set
• Turn off the lights when all people leave the house

This integration requires the integrations sun, device_tracker, person and light to be enabled.

To enable this integration, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
device_sun_light_trigger:

{% configuration %} light_group: description: Specify a specific light/group of lights that has to be turned on. required: false type: string light_profile: description: Specify which light profile to use when turning lights on. required: false default: relax type: string device_group: description: Specify which group to track. The group can contain device_trackers or persons. required: false type: string disable_turn_off: description: Disable lights being turned off when everybody leaves the house. required: false default: false type: boolean {% endconfiguration %}

A full configuration example could look like this:

# Example configuration.yaml entry
device_sun_light_trigger:
  light_group: group.living_room
  light_profile: relax
  device_group: group.my_devices
  disable_turn_off: true