Installing Hass.io


The following will take you through the steps required to install Hass.io.

  1. Download the appropriate install option:

  2. Install Hass.io:

    • Flash the downloaded image to an SD card using balenaEtcher. If using a Pi we recommend at least a 32 GB SD card to avoid running out of space. On Virtual machine platforms, provide at least 32 GB of disk space for the VM.
    • Load the appliance image into your virtual machine software. Choose 64-bit Linux and UEFI boot.
  3. Optional - set up the WiFi or static IP: On a USB stick, create the network/my-network file and follow the HassOS howto.

  4. For image-based installs insert the SD card (and optional USB stick) into the device.

  5. 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).

  6. You will be able to reach your installation at http://hassio.local:8123 (if your router supports mDNS, otherwise see below).

  7. 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 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.

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.

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. Examples given here are tested on Ubuntu, but the instructions should work as a guideline for installing on other Linux distrubutions.

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

You also need to have Docker-CE installed. There are well-documented procedures for installing Docker on Ubuntu at Docker.com, you can find installation steps for your Linux distribution in the menu on the left.

Some distributions, like Ubuntu, have a docker.io package available. Using that packages will cause issues! Be sure to install the official Docker-CE from the above listed URL.

To perform the Hass.io installation, run the following commands:

sudo -i

add-apt-repository universe

apt-get update

apt-get install -y apparmor-utils apt-transport-https avahi-daemon ca-certificates curl dbus jq network-manager socat software-properties-common

curl -fsSL get.docker.com | sh

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.