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 (SD Card virgin)

All environments

Notes and disclaimer
  • qualsiasi modifica all'impianto elettrico dev'essere progettata ed effettuata 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.1


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" Home Assistant (distribution HASSIO) on the microSD, which is the equivalent of the Hard Disk in a common personal computer.

To install the operating system you need:

  • a computer (Windows, Apple or Linux);
  • the image Home Assistant HASSIO to install;
  • the microSD and the related USB adapter.
La proThe cedura we are going to describe is valid both for Raspbian both for any other operating system and / or customization suitable for Raspberry.

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 after switching 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 If the connection fails, make sure that on the proyour router is enabled with multicast DNS (mDNS).


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.

This done, it is possible to begin to add components that can be integrated into the proprio HUB. To the topic related to the configuration file of Home Assistant dedicated a guide apposita.

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.

Please comment below