We'll be installing Home Assistant locally on a Raspberry Pi using Hass.io, an All-in-One image which turns your Pi into a home assistant hub.

The process of installing and configuring HassOS takes a while. Luckily, you only have to do it once.

First, download the latest Hass.io image for your device from the home assistant downloads page.

Then, unzip the .img.gz file. You should now have a .img file.

Burn the OS image to a fresh SD card (Home Assistant's website suggests a 32GB SD card or larger). 

WiFi Configuration

If you want to connect your Pi over WiFi, you'll need to configure Hass first. HassOS uses NetworkManager to control the host network and defaults to ethernet. 

HassOS uses a USB Drive to load configuration files like WiFi onto the Pi. The capacity of the stick does not matter - we'll be adding one file to the drive. 

We'll be overwriting the contents of the USB Drive, so back up the contents of the drive before you proceed further. 

Plug the USB drive into your computer and reformat it with the following settings:

  • Rename the drive to CONFIG
  • Format the drive as MS-DOS (FAT32)

Once reformatted, make a folder on the drive named network

Then, create a new file called my-network inside the network folder we just created.

Copy and paste the following into the file:


# Uncomment below if your SSID is not broadcasted




In the configuration, change ssid to your network's ssid and change psk to the password of your network.

If you don't want the IP address of your Pi to change on every bootup - visit this page to generate a UUID and replace uuid in the configuration with the value from the website.

Save the file to the USB drive and eject the drive from your computer. Safely eject the SD card from your computer at this time, too.

HassOS Setup

Make sure the Pi is unplugged from power.

Insert the SD card with HassOS into the Pi. Then, plug the USB drive into one of the Pi 3B+'s USB ports.

Plug the Pi in to the power supply to power it on.

Home Assistant will take from 15-20 minutes to load up on first boot. Grab a  coffee and browse adafruit.com for awhile.

Once some time has passed, navigate to hassio.local:8123.


You'll eventually be greeted with a welcome screen. Set up a new user account (this is a local account on the Raspberry Pi) and click Create Account.

After setup, you'll be directed to the Home Assistant login page. Remove the USB drive from the Raspberry Pi.

Next, we'll configure Home Assistant to be used with the Feather.

This guide was first published on Feb 07, 2019. It was last updated on May 16, 2024.

This page (Installing HassOS on Raspberry Pi) was last updated on Mar 08, 2024.

Text editor powered by tinymce.