Getting Started

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:

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:

What’s next?

To see what Home Assistant can do, launch demo mode: hass --demo-mode or visit the demo page.

Next step: Configuring Home Assistant »