installation.markdown

layout	title	description	date	sidebar	comments	sharing	footer	redirect_from
page	Installation of Home Assistant	Instructions on how to install Home Assistant to launch on start.	2017-02-15 08:00	true	false	true	true	/getting-started/installation/

Beginners should check our [Getting started guide](/getting-started/) 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](/docs/configuration/securing/) once you've finished with the installation process.

Hass.io
(Beginner friendly)

On top of an existing Python 3.5+ installation

Hassbian

Raspbian

ArchLinux

armbian

Fedora

CentOS/RHEL

Windows

macOS

Synology

Docker

Vagrant

FreeNAS

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 a minute or two 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.