Installation of Home Assistant

Beginners should check our Getting started guide first. This is for users that require advanced installations.

Home Assistant provides multiple ways to be installed. A requirement is that you have Python 3.5.3 or later installed.

Please remember to secure your installation once you’ve finished with the installation process.

Recommended options

Alternative installs

The following installs are only recommended for experienced users of those platforms.

After installation

Once Home Assistant is installed, execute the following code in a console/terminal to check if the setup was successful:

$ hass

The first start may take up to 20 minutes because the needed packages will be downloaded and installed. The web interface will be served on http://localhost:8123.

For more details about hass, please refer to the tools section.

If you’re running a Linux-based platform, we suggest you follow the VirtualEnv instructions to avoid using root.

You may need to install additional libraries depending on the platforms/components you want to use.