+
+
+ 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
.
+ Installation
+ distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix – not both
+This 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
.
+ 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
+
+
+ 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
.
+