How to Install Home Assistant Supervised on Raspberry Pi 4
If you’re ready to dive into the world of home automation, this detailed guide will help you install Home Assistant Supervised on a Raspberry Pi 4. Keep in mind, this method is experimental and primarily for advanced users. For most users, Home Assistant OS is the recommended option due to its simplicity and stability.
Important Notes
- LAN Connection Required: You must use a LAN connection during the installation process. Wi-Fi will be unavailable during certain steps.
- Experimental Setup: This setup is experimental and might not be as stable as Home Assistant OS.
- Follow each step carefully to ensure a successful installation.
Step-by-Step Installation Guide
Step 0: Update and Upgrade Your System
Before installing Home Assistant Supervised, ensure your Raspberry Pi’s operating system is up-to-date.
sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y
Step 1: Install Required Dependencies
Install the necessary packages for the setup with the following command:
sudo apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
systemd-journal-remote -y
Once installed, reboot your Raspberry Pi to apply the changes:
bash
sudo reboot
Step 2: Install Docker
Docker is the backbone of Home Assistant Supervised. Install it using the command below:
curl -fsSL get.docker.com | sh
Next, create a Docker group and add your user to it:
sudo groupadd docker
sudo usermod -aG docker $USER
Reboot your system again to apply the changes.
Step 3: Configure Docker for CGroup v1
Home Assistant Supervisor requires Docker to use CGroup v1. Follow these steps to configure it:
A. Edit GRUB Configuration
Open the GRUB configuration file:
sudo nano /etc/default/grub
Add the following line to the configuration:
systemd.unified_cgroup_hierarchy=false
Save and exit the file (CTRL+O, Enter, CTRL+X).
B. Edit Boot Configuration
Edit the boot file:
sudo nano /boot/cmdline.txt
Append the following text to the file:
systemd.unified_cgroup_hierarchy=false apparmor=1 security=apparmor
Save and exit the file (CTRL+O, Enter, CTRL+X).
Finally, reboot your system:
sudo reboot
Step 4: Install the OS-Agent
The OS-Agent is required for running Home Assistant Supervised. Follow these steps to install it:
A. Download the OS-Agent
Use the following command to download the OS-Agent package for Raspberry Pi 4 (aarch64 architecture):
wget https://github.com/home-assistant/os-agent/releases/download/1.4.1/os-agent_1.4.1_linux_aarch64.deb
B. Install the Package
Install the downloaded package:
dpkg -i os-agent_1.4.1_linux_aarch64.deb
C. Verify Installation
Check if the OS-Agent was installed successfully:
gdbus introspect –system –dest io.hass.os –object-path /io/hass/os
If you see output, the installation was successful.
Step 5: Download Home Assistant Supervised
Download the latest Home Assistant Supervised installer:
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
Step 6: Install Home Assistant Supervised
Run the installer for Home Assistant Supervised:
dpkg -i homeassistant-supervised.deb
If you encounter an error, run the following command to fix broken dependencies:
sudo apt –fix-broken install
During the installation, a blue configuration screen will appear. Select the appropriate Raspberry Pi model.
Once installed, Home Assistant will be accessible at:
http://[your_IP]:8123
If Wi-Fi is not working after installation, proceed to the next section.
Fixing Wi-Fi Issues
Step 7: Edit Network Interfaces
Open the network interfaces file:
sudo nano /etc/network/interfaces
Remove all lines except the one starting with source-directory. Use CTRL+K to delete lines. Save and exit (CTRL+O, Enter, CTRL+X).
Step 8: Enable DHCP
Enable the DHCP client:
sudo systemctl enable dhcpcd
Step 9: Disable Networking Service
Disable the networking service:
sudo systemctl disable networking
Step 10: Reboot Your Raspberry Pi
Reboot your Raspberry Pi to apply all changes:
sudo reboot
Once rebooted, Wi-Fi should work again!
Final Thoughts
Congratulations! You’ve successfully installed Home Assistant Supervised on your Raspberry Pi 4. 🎉 Now you can explore the endless possibilities of home automation.
Why Choose Home Assistant Supervised?
While Home Assistant Supervised offers flexibility and advanced features, it requires careful setup and maintenance. If you encounter issues, the Home Assistant community forums are an excellent resource.
Enjoy your new smart home setup!
