jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-20 15:56:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update guide for clarity (#4249)

Browse Source 
* Update guide for clarity

Recommends auto-starting by default, with manual starting as an option. Explicitly pull out the upgrade steps (since it also involves stopping HA first). Recommend install as a dedicated user.

* Minor changes
This commit is contained in:
DubhAd 2017-12-28 11:19:57 +00:00 committed by Fabian Affolter
parent fb883ef41d
commit 6e0ce3f41c
1 changed files with 30 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
source/_docs/installation/virtualenv.markdown
View File

@ -12,36 +12,57 @@ redirect_from: /getting-started/installation-virtualenv/
If you already have Python 3.5 or later installed, you can easily give Home Assistant a spin.
It's recommended when installing Python packages that you use a virtual environment. This will make sure that your Python installation and Home Assistant installation won't impact one another.
It's recommended when installing Python packages that you use a [virtual environment](https://docs.python.org/3.5/library/venv.html#module-venv). This will make sure that your Python installation and Home Assistant installation won't impact one another. The following steps will work on most unix like systems.
_(If you're on a Debian based system, you will need to install Python virtual environment support using `apt-get install python3-pip python3-venv`.)_
1. Create a virtual environment:
### {% linkable_title Install %}
1. Create a virtual environment in your current directory:
```
$ python3 -m venv homeassistant
```
2. Open virtual environment:
2. Open the virtual environment:
```
$ cd homeassistant
```
3. Activate virtual environment:
3. Activate the virtual environment:
```
$ source bin/activate
```
4. Install Home Assistant:
```
$ python3 -m pip install --upgrade homeassistant
$ python3 -m pip install homeassistant
```
5. Run Home Assistant:
5. Configure it to [autostart](docs/autostart/)
6. Or run Home Assistant manually:
```
$ hass --open-ui
```
### {% linkable_title Upgrade %}
1. Stop Home Assistant
2. Open the directory where the virtual environment is located:
```
$ cd homeassistant
```
3. Activate the virtual environment:
```
$ source bin/activate
```
4. Upgrade Home Assistant:
```
$ python3 -m pip install --upgrade homeassistant
```
5. Start Home Assistant
### {% linkable_title Notes %}
- In the future, if you want to start Home Assistant again, follow step 2, 3 and 5.
- If you want to upgrade Home Assistant, follow step 2, 3 and 4.
- In the future, if you want to start Home Assistant manually again, follow step 2, 3 and 5.
- It's recommanded to run Home Assistant as a dedicated user.
<p class='info'>
Looking for more advanced guides? Check our [Rasbian guide](/docs/installation/raspberry-pi/) or the [available installation guides](/docs/installation/]. For details about autostarting, refer to the [autostart section](/docs/autostart/) in the documentation.
Looking for more advanced guides? Check our [Rasbian guide](/docs/installation/raspberry-pi/) or the [other installation guides](/docs/installation/].
</p>