Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 11 additions & 9 deletions source/_components/updater.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@ title: "Updater"
description: "Detecting when Home Assistant updates are available."
logo: home-assistant.png
ha_category:
- Other
- binary_sensor
ha_qa_scale: internal
ha_release: 0.8
---

The `updater` integration will check daily for new releases. It will show a badge in the frontend if a new version is found. As [Hass.io](/hassio/) has its own schedule for release it doesn't make sense to use this integration on Hass.io.
The `updater` binary sensor will check daily for new releases. The state will be "on" when an update is available. Otherwise, the state will be "off". The newer version, as well as the link to the release notes, are attributes of the updater. As [Hass.io](/hassio/) has its own schedule for release it doesn't make sense to use this binary sensor on Hass.io.

The updater integration will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the time zone, Python version and operating system information. No identifiable information (i.e., IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/updater.py#L91).
The updater will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the time zone, Python version and operating system information. No identifiable information (i.e., IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/updater.py#L91).

## Configuration

Expand Down Expand Up @@ -59,12 +59,14 @@ For an added bonus, an automation integration can be created to send a message w
```yaml
# Example configuration.yaml entry
automation:
alias: 'Update Available Notifications'
alias: Update Available Notification
trigger:
platform: state
entity_id: updater.updater
- platform: state
entity_id: binary_sensor.updater
from: 'off'
to: 'on'
action:
service: notify.notify
data:
message: 'Update for Home Assistant is available.'
- service: notify.notify
data:
message: 'Update for Home Assistant is available.'
```