jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Adjust getting started section for 0.7

Browse source
This commit is contained in:
Paulus Schoutsen 2015-08-30 21:55:49 -07:00
parent 1621c9a83f
commit fe2b626446
5 changed files with 136 additions and 84 deletions
Download patch file Download diff file Expand all files Collapse all files

55
source/getting-started/troubleshooting.markdown
View file

@ -1,7 +1,7 @@
---
layout: page
title: "Troubleshooting"
description: "Common problems and their solutions."
title: "Troubleshooting installation problems"
description: "Common installation problems and their solutions."
date: 2015-01-20 22:36
sidebar: false
comments: false
@ -9,43 +9,26 @@ sharing: true
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**<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/).
**pip3: command not found**<br>
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](https://www.python.org/getit/).
If you are to succesfully run `python3 --version` but not `pip3`, run the following command instead
to install Home Assistant: `python3 -m pip install homeassistant`.
**No module named pip**<br>
[Pip](https://pip.pypa.io/en/stable/) 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**<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).
**No module named 'pytz'**<br>
There is a problem with installing dependencies on the fly. Install the dependencies manually in advance.
```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.
```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.
[Pip](https://pip.pypa.io/en/stable/) 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`.
**No access to the frontend**<br>
In newer Linux distributions (at least Fedora 22/CentOS 7) the access to a host are very limited. This means that you can't access the Home Assistant Frontend that is running on a host in your network. Check the Post-installation section on the [Getting started]({{site_root}}/getting-started/index.html) page and follow the instruction that match your distribution to allow access to port 8123.
In newer Linux distributions (at least Fedora 22/CentOS 7) the access to a host are very limited.
This means that you can't access the Home Assistant Frontend that is running on a host in your
network. Check the Post-installation section on the [Getting started](/getting-started/) page and
follow the instruction that match your distribution to allow access to port 8123.