4.8 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 target="_blank"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
Troubleshooting
If you run into any issues, please see the troubleshooting page. It contains solutions to many of the common 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.
Staying Up to Date
In order to update Home Assistant to the latest stable release, simply type the following into a console:
```bash pip install --upgrade homeassistant ```If you would like to stay up to date with the newest unstable builds (alphas, betas, and release candidates), use this command:
```bash pip install --upgrade --pre homeassistant ```What's Next
If you want to see what Home Assistant can do, you can start the demo mode by running hass --demo-mode. Home Assistant has a few other command line flags that can be displayed by running hass --help.
From here you may now start configuring Home Assistant to your liking. For more advanced users, the advanced configuration page contains brief tutorials on creating more advanced installations.