The sun integration will use the location as configured in your Home Assistant configuration to track if the sun is above or below the horizon. The sun can be used within automations as a trigger with an optional offset to simulate dawn/dusk or as a condition with an optional offset to test if the sun has already set or risen.

Configured by default

This integration is by default configured and installed, and you don’t need to configure it yourself, unless you’ve disabled or removed the default_config: line from your YAML configuration.

If that is the case, you can configure it as described in the next paragraphs.


Adding Sun to your Home Assistant instance can be done via the user interface, by using this My button:

Manual configuration steps

YAML Configuration

Alternatlively, this integration can be configured and set up manually via YAML instead. To enable the sun integration in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry

Implementation Details

The sun’s event listener will call the service when the sun rises or sets with an offset.

The sun event need to have the type ‘sun’, which service to call, which event (sunset or sunrise) and the offset.

    "type": "sun",
    "service": "switch.turn_on",
    "event": "sunset",
    "offset": "-01:00:00"

Maintains entity sun.sun

Possible state Description
above_horizon When the sun is above the horizon.
below_horizon When the sun is below the horizon.
State Attributes Description
next_rising Date and time of the next sun rising (in UTC).
next_setting Date and time of the next sun setting (in UTC).
next_dawn Date and time of the next dawn (in UTC).
next_dusk Date and time of the next dusk (in UTC).
next_noon Date and time of the next solar noon (in UTC).
next_midnight Date and time of the next solar midnight (in UTC).
elevation Solar elevation. This is the angle between the sun and the horizon. Negative values mean the sun is below the horizon.
azimuth Solar azimuth. The angle is shown clockwise from north.
rising True if the Sun is currently rising, after solar midnight and before solar noon.