Installing Hass.io

Hass.io images are available for all available Raspberry Pi and Intel NUC platforms.

• Download the appropriate image for your Raspberry Pi / Intel NUC:
  • Raspberry Pi / Zero
  • Raspberry Pi 2
  • Raspberry Pi 3
  • Intel NUC
• Flash the downloaded image to an SD card using Etcher.
• Optional - Setup the WiFi or static IP: On the SD-card, edit the system-connections/resin-sample file and follow the ResinOS howto.
• Insert SD card to 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 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.

Alternative: install on generic Linux server

For advanced users, it is also possible to try Hass.io on your Linux server or inside a VM. To do so, follow these instructions.

When you use this installation method, some add-ons will not be available and the documentation might not work for your installation.