FAQ
This is a community curated list of frequently asked questions (FAQ) about the installation, setup, and usage of Home Assistant.
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
.
Documentation
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.
Installation
No module named pip
Pip should come bundled with the latest Python 3 but is omitted by some distributions. If you are unable to run python3 -m pip --version
you can install pip
by downloading the installer and running it with Python 3:
$ python3 get-pip.py
distutils.errors.DistutilsOptionError
The problem which leads to distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both
is a known issue if you’re on a Mac using Homebrew to install Python. Please follow these instructions to resolve it.
libyaml is not found or a compiler error
On a Debian system, install the Python 3 YAML library by sudo apt-get install python3-yaml
.
pip3: command not found
This utility should have been installed as part of the Python 3.4 installation. Check if Python 3.4 is installed by running python3 --version
. If it is not installed, download it here.
If you are able to successfully run python3 --version
but not pip3
, install Home Assistant by running the following command instead:
$ python3 -m pip install homeassistant
On a Debian system, you can also install python3 by sudo apt-get install python3
d and pip3 by sudo apt-get install python3-pip
.
Usage
After upgrading, your browser login gets stuck
After upgrading to a new version, you may notice your browser gets stuck at the “loading data” login screen. Close the window/tab and go into your browser settings and delete all the cookies for your URL. You can then log back in and it should work.
Android Chrome
chrome -> settings -> site settings -> storage -> search for your URL for home assistant-> “clear & reset”
Connection error
It can happen that you get a traceback that notify you about connection issues while running Home Assistant. Eg.
ConnectionRefusedError: [Errno 111] Connection refused
The chance is very high that this is not a bug but an issue with the service/daemon itself. Check your network (DNS, DHCP, uplink, etc.) first and make sure that Home Assistant and the service are poperly configured. Keep in mind that webservices can be down.
Dependencies
The dependencies which are used by Home Assistant are stored in the folder deps
of the configuration folder directory. After an upgrade the dependences will be upgraded as well.
Problems with dependencies
Almost all components have external dependencies to communicate with your devices and services. Sometimes Home Assistant is unable to install the necessary dependencies. If this is the case, it should show up in home-assistant.log
.
The first step is trying to restart Home Assistant and see if the problem persists. If it does, look at the log to see what the error is. If you can’t figure it out, please report it so we can investigate what is going on.