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

Updating

To update Home Assistant to the latest release check the Updating section.

Troubleshooting

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 »