How to install and configure Home Assistant (HASSIO) on a Raspberry Pi dedicated

4 minutes of reading
  • Install and configure Home Assistant (distribution HASSIO)
  • Difficulty level: bass
  • software installation and configuration
  • Home network connected to the Internet
  • Raspberry Pi not configured (virgin microSD or in any case erasable because not used)

All environments

Notes and disclaimer
  • qualsiasi eventuale modifica agli impianti domestici dev'essere progettata ed realizzata SOLO da personale qualificato;
  • any changes implemented in probefore is a propersonal responsibility as well as a profirst risk and danger (the contents of the present page are purely educational);
  • any changes implemented in proprior to a device it voids the guarantee, quality approvals and certifications.
Driving review: 1.3


As explained in other tabs, Home Assistant is the one among the HUB ideal personal to make one profirst personal home automation in an organic and functional way. This crucial software component has the possibility to be installed on many systems and in different ways: Its Raspberry Pi the modality usually favored by the developers is the mode "HASSIO”, or a yes mode fully automatic, which however plans to dedicate the Raspberry Pi for exclusive use di Home Assistant, effectively closing any other features.

This guide covers probefore this approccio.
The alternative
, for those wishing to use the advantages of distribution HASSIO while maintaining the flexibility of the operating system Raspbian, is to install it via Docker.

A list possible alternatives installation is available here.

Home Assistant Official Logo



Before starting the Raspberry Pi, it is necessary to "install" the operating system on the microSD, which is the equivalent of the Hard Disk in a common personal computer. This operating system is available in many versions and customizations; on inDomus we will often refer to the most classic, supported and complete available today, or Raspbian.
Nb Su Raspberry Pi it is also possible to use, instead of a microSD, an external disk connected via USB. To this proposito is recommended reading this other card.
To install the operating system you need:

Install HASSIO on the SD Card

To install HASSIO on Raspberry, le procedures are different depending on the computer you have available.

Proprocedure WINDOWS

  • download and install the software Etcher da;
  • download the free image of HASSIO from here:
  • connect the microSD to the computer;
  • perform Etcher;
  • select the image previously downloaded;
  • select the microSD;
  • click "Burn" to install the image on the microSD;
  • wait for the task to complete, then extract the microSD, now proestablished for the use of HASSIO.
The Etcher software

Proprocedure MAC


  • download and install the software Etcher da;
  • download the free image of HASSIO from here:
  • connect the microSD to the computer;
  • perform Etcher;
  • select the image of HASSIO previously downloaded;
  • select the microSD;
  • Click "Burn" to install the image of HASSIO on the microSD;
  • wait for the task to complete, then extract the microSD, now proestablished for the use of HASSIO.
The Etcher software

with TERMINAL (for those familiar with the command line)

diskutil list
to identify the disk (NOT the partition), eg disk4 and not disk4s1
  • remove the disk with the command
diskutil unmountDisk /dev/disk<disk# from diskutil>
indicating the previously identified disk eg discussil unmountDisk / dev / disk4
  • install the image using the command
sudo dd bs=1m if=image.img of=/dev/rdisk<disk# from diskutil> conv=sync
where image.img is the image to be copied and disk # is the previously identified disk (hence the microSD)
sudo dd bs=1m if=2018-04-18-raspbian-stretch.img of=/dev/rdisk4 conv=sync

Procedura Linux

Also for linux is available Etcher (same sequence described above) or you can use the CLI. In this case, similarly to proprocedure Mac, it is sufficient to identify the disk (the microSD) to be removed by the command
after which it is sufficient to use the command
dd bs=4M if=image.img of=/dev/sdX conv=fsync
where image.img is the image to be copied and sdX is the previously identified disk (hence the microSD)
More information on the proLinux cedures are available here.

Network customization

At this point we can insert the microSD inside the Raspberry, but we are not yet prostarted at the first start: we must indeed guarantee network access to the latter. There are two roads: wired or network Wi-Fi.
for wired network simply connect the Raspberry port to any of the routers via an ethernet cable. If this is the preferred route, prosee, turn on the Raspeberry and move on.
If instead we want to use the network Wi-Fi, we must still perform a last, trivial operational step.
Equip yourself with a banal USB pendrive, format it (FAT32, NTFS, EXT4 - is indifferent) and christen it "CONFIG"
After that, log in and create a folder called "network"; one time prosaw it, access it and create a text file (without extension) with the name “my-network"Containing the following text:

# Uncomment below if your SSID is not broadcasted



Customize the text thus taking care to insert the name of the proman Wi-Fi in the field "ssid" and the password for access in the field "psk". Save and disconnect the USB stick. At this point insert - with Raspberry off - both the microSD and the USB key in the appositi housings of the raspberry, after which to turn it on.
This will cause the Raspberry to enter at the first boot automatically - and forever - inside the Wi-Fi. The key, after the first boot, can be removed.

First access on Home Assistant

After (at least) twenty minutes from power on, HASSIO will finally be running on our Raspberry.
At this point, log on to HASSIO pointing on proyour computer's browser apphere is the following address:


Nb In case you can't connect, make sure on proown router DNS multicast (mDNS) is active. If it isn't, the name resolution “hassio.local"Is not successful and the browser is unable to connect: the solution, for theappanointed, is to activate multicast (which prosee this thing). Alternatively, however, it is always possible to connect to the direct address, that is http://INDIRIZZO_IP_DEL_RASPBERRY:8123, where the IP address is the one assigned by the router to Raspberry Pi.

It should appto set up a site similar to this:

Home Assistant - Onboarding
Which allows you to set the first, elementary and personal "onboarding" information related to the profirst home automation.
Compliments! Home Assistant It is running.


At this point HASSIO and yes pronto, but there are some perfectionsnamenti, which derive from the installation of additional components we consider "essential", to be implemented.

Regardless, it always remains useful consult the card which illustrates all the things to do after this one first installation.

Home Assistant Official LogoATTENZIONE: remember that there is on our FORUM community an ad hoc section dedicated to Home Assistant, for any doubt, question, information on the specific merit of these components.
inDomus telegram channel