diff --git a/source/getting-started/troubleshooting.markdown b/source/getting-started/troubleshooting.markdown index 1ba127783b0..e3f967c4e46 100644 --- a/source/getting-started/troubleshooting.markdown +++ b/source/getting-started/troubleshooting.markdown @@ -11,10 +11,37 @@ footer: 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](https://www.python.org/getit/). +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](https://bootstrap.pypa.io/get-pip.py) 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](http://git-scm.com/downloads). +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](https://bugs.launchpad.net/ubuntu/+source/python3.4/+bug/1290847). If you are encountering an error that looks like the following while creating the virtual environment, you are experiencing this bug. + +```bash +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. + +```bash +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.