Below you can find the standard instructions. See the sidebar for installation instructions for specific platforms. If you’re running a Linux-based platform, we suggest you follow the VirtualEnv Linux instructions to avoid using root.
Installing and running Home Assistant on your local machine is easy. The only requirement is that you have Python installed. For Windows we require at least Python 3.5 and for other operating systems at least Python 3.4.2. Once installed, execute the following code in a console:
$ pip3 install homeassistant $ hass --open-ui
Running these commands will:
- Install Home Assistant
- Launch Home Assistant and serve the web interface on http://localhost:8123
If you prefer to watch a video tutorial, tktino has made some great ones:
To update Home Assistant to the latest release check the Updating section.
If you run into any issues, please see the troubleshooting page. It contains solutions to many commonly encountered issues.
In addition to this site, check out these sources for additional help:
- Forum for Home Assistant discussions and questions
- Gitter Chat Room for real-time chat about Home Assistant
- GitHub Page for issue reporting
To see what Home Assistant can do, launch demo mode:
hass --demo-mode or visit the demo page.