home-assistant.io/source/_components/version.markdown

layout, title, description, date, sidebar, comments, sharing, footer, ha_category, ha_iot_class, logo, ha_release, ha_qa_scale, redirect_from

layout	title	description	date	sidebar	comments	sharing	footer	ha_category	ha_iot_class	logo	ha_release	ha_qa_scale	redirect_from
page	Version Sensor	Instructions on how to integrate a version sensor into Home Assistant.	2017-08-10 10:30	true	false	true	true	Utility	Local Push	home-assistant.png	0.52	internal	/components/sensor.version/

The version sensor platform that can display the current Home Assistant versions.

{% linkable_title Configuration %}

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

# Example configuration.yaml entry
sensor:
  - platform: version

{% configuration %} name: description: Name to use in the frontend. required: false type: string default: "Current Version in case of source: local, Latest Version otherwise" beta: description: Flag to indicate that it will check for beta versions, only supported for the sources pypi, hassio and docker. required: false type: boolean default: false image: description: The image you want to check against, this is only supported for hassio, see full list under. required: false type: string default: default source: description: The source you want to check against, possible values are local, pypi, hassio and docker. required: false type: string default: local {% endconfiguration %}

{% linkable_title Supported images for Hassio %}

default, qemux86, qemux86-64, qemuarm, qemuarm-64, intel-nuc, raspberrypi, raspberrypi2, raspberrypi3, raspberrypi3-64, tinker, odroid-c2, odroid-xu

{% linkable_title Alternatives for showing local version %}

This sensor is an alternative to the existing solutions to achieve the same result through various platforms. Remember that you can easily get the installed version on the command line.

hass --version

Or go to the Info section of the Developer Tools.

A command_line with hass to display your current version.

sensor:
  - platform: command_line
    name: Version
    command: "/home/homeassistant/bin/hass --version"

It's also possible to read a file called .HA_VERSION which is located in your Home Assistant configuration folder.

sensor:
  - platform: command_line
    name: Version
    command: "cat /home/homeassistant/.homeassistant/.HA_VERSION"

You might think that a rest sensor could work, too, but it will not as Home Assistant is not ready when the sensor gets initialized.

{% raw %}

sensor:
  - platform: rest
    resource: http://IP_ADDRESS:8123/api/config
    name: Current Version
    value_template: '{{ value_json.version }}'

{% endraw %}