6e0790d7d0
* Install guide tweaks - Moved the guide to a numbered list so it's more clearly step by step - Moved the power supply warning out, so it doesn't break the list - Highlighted and broken out the parts that only apply to the image based installs - Standardised some of the links so none are inline - HIghlighted that `hassio.local` requires working mDNS - A few minor wording tweaks * Update installation.markdown * Update installation.markdown * Update installation.markdown
5.1 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Installing Hass.io | Instructions on how to install Hass.io. | 2017-04-30 13:28 | true | false | true | true |
The following will take you through the steps required to install Hass.io.
-
Download the appropriate install option:
-
As an image for your device:
-
As a virtual appliance:
-
-
Install Hass.io:
- Flash the downloaded image to an SD card using Etcher. We recommend at least a 32 GB SD card to avoid running out of space.
- Load the appliance image into your virtual machine software.
-
Optional - set up the WiFi or static IP: On a USB stick, create the
network/my-networkfile and follow the HassOS howto. -
For image based installs insert the SD card (and optional USB stick) into the device.
-
Turn on your device or virtual appliance. On first boot, it downloads the latest version of Home Assistant which takes around 20 minutes (slower/faster depending on the platform and your Internet connection).
-
You will be able to reach your installation at http://hassio.local:8123 (if your router supports mDNS, otherwise see below).
-
Enable either the Samba add-on or the SSH add-on to manage your configuration in
/config/(From the UI choose Hass.io which is located in the sidebar).
If your router doesn't support mDNS, then you'll have to use the IP address of your Pi instead of `hassio.local`. For example, `http://192.168.0.9:8123`. You should be able to find the IP address of your Pi from the admin interface of your router.
If you are using a Raspberry Pi please remember to ensure you're using an [appropriate power supply][pi-power] with your Pi. Mobile chargers may not be suitable since some were only designed to provide just enough power to the device it was designed for by the manufacturer. **Do not** try to power the Pi from the USB port on a TV, computer, or similar.
Now you can configure your install.
{% linkable_title Migrating from a non-Hass.io install %}
If you copy over your existing Home Assistant configuration, make sure to enable the Hass.io panel by adding either discovery: or hassio: to your configuration.
{% linkable_title Alternative: install on generic Linux server %}
For advanced users, it is also possible to try Hass.io on your Linux server or inside a virtual machine.
This is the list of packages you need to have available on your system that will run Hass.io if you are using Debian/Ubuntu:
- apparmor-utils
- apt-transport-https
- avahi-daemon
- ca-certificates
- curl
- dbus
- jq
- network-manager
- socat
- software-properties-common
To perform the Hass.io installation, run the following command as root:
$ curl -sL https://raw.githubusercontent.com/home-assistant/hassio-build/master/install/hassio_install | bash -s
When you use this installation method, the core SSH add-on may not function correctly. If that happens, use the community SSH add-on. Some of the documentation might not work for your installation either.
A detailed guide about running Hass.io as a virtual machine is available in the blog.