+ Why are you using YAML for the configuration file?
+
+
+
+
And not JSON or XML for the configuration file? Because YAML can be written by hand, you don’t have to care about commas or tag and it’s a superset of JSON.
Why are you not using tools X for the documentation? Because the current solution works for us and we see no additional value in using a seperate publishing platform.
This is a community curated list of frequently asked questions (FAQ) about the installation, setup, and usage of Home Assistant.
+
Common
+
Python 2
+
There will be no support for Python 2.x. Python 2 will be EOL in 2020 and it doesn’t make any sense to support a release which was planned to be retired in 2015.
Configuration
My component does not show up
When a component does not show up, many different things can be the case. Before you try any of these steps, make sure to look at the home-assistant.log file and see if there are any errors related to your component you are trying to set up.
If you have incorrect entries in your configuration files you can use the check_config script to assist in identifying them: hass --script check_config.
+
Why are you using YAML for the configuration file?
+
And not JSON or XML for the configuration file? Because YAML can be written by hand, you don’t have to care about commas or tag and it’s a superset of JSON.
Documentation
+
Documentation tools
+
Why are you not using tools X for the documentation? Because the current solution works for us and we see no additional value in using a seperate publishing platform.
Missing Documentation
Home Assistant is a FAST moving open source project. This means occasionally the official documentation will not be 100% current or complete. Since this is an open source volunteer project, we would encourage anyone who finds gaps in the documentation to click the edit this page on Github link in the top right and submit any corrections/enhancements they may find useful.
In the absence of information, many users find it beneficial to look at other people’s configurations to find examples of what they want to accomplish in thier own configurations. The easiest way to find these configurations is through this Github search.
There will be no support for Python 2.x. Python 2 will be EOL in 2020 and it doesn’t make any sense to support a release which was planned to be retired in 2015.