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 to follow the VirtualEnv Linux instructions to avoid using root.

Installing and running Home Assistant on your local machine is easy. Make sure you have Python 3.4 or higher installed and 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 »