4.4 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 |
Hass.io images are available for:
- Download the appropriate image for your device:
- As Virtual Appliance:
Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) 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.
-
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.
-
Optional - Setup the WiFi or static IP: On a USB stick, create the
network/my-networkfile and follow the HassOS howto. -
Insert the SD card (and optional USB stick) into the Raspberry Pi and turn it on. On first boot, it downloads the latest version of Home Assistant which takes ~20 minutes (slower/faster depending on the platform).
- You will be able to reach your installation at http://hassio.local:8123.
- 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.
{% 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.