Update troubleshoot guide

This commit is contained in:
Paulus Schoutsen 2015-07-19 13:20:41 -07:00
parent c85e9978f5
commit 1e7fa3aee3
2 changed files with 12 additions and 12 deletions

@ -1 +1 @@
Subproject commit 1e601ac57f1afbc285a357bcb91e8c5d1af0b9f8 Subproject commit 6fc63bb3fa0a9eb08deba83f7fd907c0a893876c

View File

@ -11,24 +11,24 @@ 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. 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 **python3: command not found**<br>
==========================
Check if Python 3.4 is installed by running `python3 --version`. If it is not installed, [download it here](https://www.python.org/getit/). 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 **No module named pip**<br>
===================
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`. 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 **git: command not found**<br>
======================
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). 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 **No module named 'pytz'**<br>
================================ There is a problem with installing dependencies on the fly. Install the dependencies manually in advance.
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 ```bash
=============================================== python3 -m pip install --upgrade pip
python3 -m pip install --upgrade -r requirements.txt
```
**Ubuntu 14.04: ... returned non-zero exit status**<br>
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. 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 ```bash