mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-06 11:08:59 +00:00
1edbbfeb1f
Trying to split this into "first class" and "here be dragons". The aim being to make less experienced folks less likely to dive directly into things like Armbian, or Mac, or ...
134 lines
4.7 KiB
Markdown
134 lines
4.7 KiB
Markdown
---
|
|
layout: page
|
|
title: "Installation of Home Assistant"
|
|
description: "Instructions on how to install Home Assistant to launch on start."
|
|
date: 2017-02-15 08:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
redirect_from: /getting-started/installation/
|
|
---
|
|
|
|
<p class='note'>
|
|
Beginners should check our [Getting started guide](/getting-started/) first. This is for users that require advanced installations.
|
|
</p>
|
|
|
|
Home Assistant provides multiple ways to be installed. A requirement is that you have [Python 3.5.3 or later](https://www.python.org/downloads/) installed.
|
|
|
|
<p class='note warning'>
|
|
Please remember to [secure your installation](/docs/configuration/securing/) once you've finished with the installation process.
|
|
</p>
|
|
|
|
## {% linkable_title Recommended options %}
|
|
|
|
<div class="text-center hass-option-cards" markdown="0">
|
|
<a class='option-card' href='/getting-started/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/home-assistant.png' />
|
|
</div>
|
|
<div class='title'>Hass.io<br>(Beginner friendly)</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/hassbian/installation/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/home-assistant.png' />
|
|
</div>
|
|
<div class='title'>Hassbian (for the Raspberry Pi)</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/docker/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/docker.png' />
|
|
</div>
|
|
<div class='title'>Docker</div>
|
|
</a>
|
|
</div>
|
|
|
|
## {% linkable_title Alternative installs %}
|
|
|
|
The following installs are only recommended for experienced users of those platforms.
|
|
|
|
<div class="text-center hass-option-cards" markdown="0">
|
|
<a class='option-card' href='/docs/installation/raspberry-pi/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/raspberry-pi.png' />
|
|
</div>
|
|
<div class='title'>Raspbian (but applies to any Debian based Linux)</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/virtualenv/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/python.svg' />
|
|
</div>
|
|
<div class='title'>On top of an existing Python 3.5.3+ installation</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/armbian/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/armbian.png' />
|
|
</div>
|
|
<div class='title'>armbian</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/archlinux/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/archlinux.png' />
|
|
</div>
|
|
<div class='title'>ArchLinux</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/fedora/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/fedora.png' />
|
|
</div>
|
|
<div class='title'>Fedora</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/centos/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/centos.png' />
|
|
</div>
|
|
<div class='title'>CentOS/RHEL</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/windows/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/windows.png' />
|
|
</div>
|
|
<div class='title'>Windows</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/macos/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/apple.png' />
|
|
</div>
|
|
<div class='title'>macOS</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/synology/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/synology.png' />
|
|
</div>
|
|
<div class='title'>Synology</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/vagrant/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/vagrant.png' />
|
|
</div>
|
|
<div class='title'>Vagrant</div>
|
|
</a>
|
|
<a class='option-card' href='/docs/installation/freenas/'>
|
|
<div class='img-container'>
|
|
<img src='/images/supported_brands/freenas.png' />
|
|
</div>
|
|
<div class='title'>FreeNAS</div>
|
|
</a>
|
|
</div>
|
|
|
|
## {% linkable_title After installation %}
|
|
|
|
Once Home Assistant is installed, execute the following code in a console/terminal to check if the setup was successful:
|
|
|
|
```bash
|
|
$ 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](http://localhost:8123).
|
|
|
|
For more details about `hass`, please refer to the [tools section](/docs/tools/hass/).
|
|
|
|
If you're running a Linux-based platform, we suggest you follow the [VirtualEnv instructions](/docs/installation/virtualenv/) to avoid using `root`.
|
|
|
|
You may need to install additional libraries depending on the platforms/components you want to use.
|