12409a5bfa
Added Ubuntu fix instructions to troubleshooting and some headers to organize the information.
2.4 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Troubleshooting | Common problems and their solutions. | 2015-01-20 22:36 | false | false | true | true |
It can happen that you run into trouble while installing Home Assistant. This page is here to help you figure out the most common problems.
python3: command not found
Check if Python 3.4 is installed by running python3 --version. If it is not installed, download it here.
No module named pip
Pip should come bundled with the latest Python 3 but is ommitted by some distributions. If you are unable to run python3 -m pip --version you can install pip by downloading the installer and run it with Python 3: python3 get-pip.py.
git: command not found
Check if Git is installed by running git --version. If you are unable to run this command you can install it by following these instructions.
Home Assistant Failing to Launch
When you are on Linux, it can happen that the requirements fail to install. If this is the case you can fix this by installing the Python 3 development package. For Debian/Ubuntu this can be done by running apt-get install python3-dev.
Ubuntu 14.04: ... returned non-zero exit status
There is a known issue with installing on Ubuntu 14.04 and possibly many other newer Debian based distributions. The venv Python 3.4 package that has been bundled in the apt-get repository are known to be broken. This has been documented in this bug report. If you are encountering an error that looks like the following while creating the virtual environment, you are experiencing this bug.
Error: Command '['home-assistant/bin/python3.4', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status
This error can be fixed permanently by running the following commands.
cd ~/Downloads
wget https://gist.githubusercontent.com/rmkraus/c3972492a9de875203c6/raw/46629b63857537deedc85ec4a11cd8284816e2a0/install_ensurepip.py
sudo python3 install_ensurepip.py
rm install_ensurepip.py
After these commands have been successfully executed, the venv package will be fixed system-wide.