Version Sensor

The version sensor platform is displaying the current version of Home Assistant in the frontend.


To enable this sensor, add the following lines to your configuration.yaml file for a GET request:

# Example configuration.yaml entry
  - platform: version

Configuration Variables


(string)(Optional)Name to use in the frontend.

Default value: Current 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 service developer tool icon Info section of the Developer Tools.

A command_line with hass to display your current version.

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

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

  - 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 get initialized.

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