Updater
Starting with 0.31 the updater component sends an optional report about Home Assistant instance.
If you want to opt-in to include component information, add include_used_components
to your config. This will allow the Home Assistant developers to focus development efforts on the most popular components.
updater:
include_used_components: true
We are only collecting this information to better understand our user base to provide better long term support and feature development.
Name | Description | Example | Data Source |
---|---|---|---|
arch |
CPU Architecture | x86_64 |
Local Instance |
distribution |
Linux Distribution name (only Linux) | Ubuntu |
Local Instance |
docker |
True if running inside Docker | false |
Local Instance |
first_seen_datetime |
First time instance ID was submitted | 2016-10-22T19:56:03.542Z |
Update Server |
geo_city |
GeoIP determined city | Oakland |
Update Server |
geo_country_code |
GeoIP determined country code | US |
Update Server |
geo_country_name |
GeoIP determined country name | United States |
Update Server |
geo_latitude |
GeoIP determined latitude | 37.8047 |
Update Server |
geo_longitude |
GeoIP determined longitude | -122.2124 |
Update Server |
geo_metro_code |
GeoIP determined metro code | 807 |
Update Server |
geo_region_code |
GeoIP determined region code | CA |
Update Server |
geo_region_name |
GeoIP determined region name | California |
Update Server |
geo_time_zone |
GeoIP determined time zone | America/Los_Angeles |
Update Server |
geo_zip_code |
GeoIP determined zip code | 94602 |
Update Server |
last_seen_datetime |
Most recent time instance ID was submitted | 2016-10-22T19:56:03.542Z |
Update Server |
os_name |
Operating system name | Darwin |
Local Instance |
os_version |
Operating system version | 10.12 |
Local Instance |
python_version |
Python version | 3.5.2 |
Local Instance |
timezone |
Timezone | America/Los_Angeles |
Local Instance |
user_agent |
User agent used to submit analytics | python-requests/2.11.1 |
Local Instance |
uuid |
Unique identifier | 10321ee6094d4a2ebb5ed55c675d5f5e |
Local Instance |
version |
Home Assistant version | 0.31.0 |
Local Instance |
virtualenv |
True if running inside virtualenv | true |
Local Instance |
In addition to the above collected data, the server will also use your IP address to do a geographic IP address lookup to determine a general geographic area that your address is located in. To be extremely, extremely clear about this bit: The Home Assistant updater does not: store your IP address in a database and also does not submit the location information from your configuration.yaml
.
Our tests showed that at best, we get 4 digits of accuracy on your IP address location which is a 5 mile radius of your actual IP location, assuming that it is even correct in the first place (geo IP lookups are very hit or miss).
The server also adds two timestamps to the data:
- the original date your instance UUID was first seen
- the timestamp of the last time we have seen your instance
We will never publicly expose individual gathered data. We might however publish aggregated stats about our user base (example: 70% of all users use Linux). We will never sell or allow the use of this information for non-Home Assistant development purposes.