4.1 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Getting Started | Step by step guide to get started with Home Assistant. | 2014-12-18 22:57 | false | false | true | true |
Installation
```bash pip3 install homeassistant hass \-\-open-ui ```
Running these commands will:
- Install Home Assistant
- Launch Home Assistant and serve web interface on http://localhost:8123
Installation with Docker is straightforward. Adjust the following command so that /path/to/your/config/ points at the folder where you want to store your config and run it:
docker run -d \-\-name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro \-\-net=host balloob/home-assistant
This will launch Home Assistant and serve its web interface from port 8123 on your Docker host.
When using boot2docker on OS X you are unable to map the local time to your Docker container. Replace -v /etc/localtime:/etc/localtime:ro with -e "TZ=America/Los_Angeles" (replacing America/Los_Angeles with your timezone)
Home Assistant uses Python 3.4 which is not shipped with the current Raspbian distibution for the Raspberry Pi. Before installing Home Assistant, you will have to install Python 3.4.
Once that is complete, installing and running Home Assistant on your local machine is easy. Make sure you have Python 3.4 installed and execute the following code in a console:
```bash pip3 install homeassistant hass \-\-open-ui ```
Running these commands will:
- Install Home Assistant
- Launch Home Assistant and serve web interface on http://localhost:8123
{% linkable_title Troubleshooting %}
If you run into any issues, please see the troubleshooting page. It contains solutions to many of the more commonly encountered issues.
For additional help, in addition to this site, there are three sources:
- Gitter Chatroom for general Home Assistant discussions and questions.
- Development Mailing List for development related questions and discussing new features.
- GitHub Page for issue reporting.
{% linkable_title What's next %}
If you want to have Home Assistant start on boot, autostart instructions can be found here.
To see what Home Assistant can do, launch demo mode:
hass \-\-demo-mode
To update Home Assistant to the latest release:
pip3 install \-\-upgrade homeassistant