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).
- If you do not know how to install an OS onto a SD card for the Raspberry Pi, follow this page and come back when you're done.
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.
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:
[connection] id=hassos-network uuid=72111c67-4a5d-4d5c-925e-f8ee26efb3c3 type=802-11-wireless [802-11-wireless] mode=infrastructure ssid=MY_SSID # Uncomment below if your SSID is not broadcasted #hidden=true [802-11-wireless-security] auth-alg=open key-mgmt=wpa-psk psk=MY_WLAN_SECRET_KEY [ipv4] method=auto [ipv6] addr-gen-mode=stable-privacy method=auto
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.
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.
Page last edited March 08, 2024
Text editor powered by tinymce.
