Home Assistant on Raspberry Pi: Setup Guide (2026)
Running Home Assistant on a Raspberry Pi gives you a private, locally controlled smart-home hub that you own outright. The short version: use a Raspberry Pi 4 or 5, write the official Home Assistant Operating System (HAOS) image to fast storage with the Raspberry Pi Imager, power it from a quality supply, then finish onboarding in a browser at http://homeassistant.local:8123. Below is the full process, why each step matters, and how to keep the system stable afterward.
What you'll need before you start
Home Assistant runs on modest hardware, but the right parts prevent most of the frustration people report on the community forums — corrupted storage, random reboots, and sluggish dashboards. Here's a practical baseline.
- The board. A Raspberry Pi 4 with 4GB of RAM handles a typical home with dozens of devices comfortably. The Pi 5 is faster and a better choice if you plan to run many add-ons (databases, media tools, network monitoring).
- Storage. SD cards wear out from Home Assistant's constant small writes, and a failing card is the single most common cause of a hub that "suddenly died." A USB-attached SSD (or NVMe on the Pi 5) is dramatically more durable.
- Power. Use the official power supply. Underpowering a Pi causes intermittent crashes that are very hard to diagnose. The Pi 5 in particular expects its 27W USB-C supply to power USB peripherals reliably.
- Network. Wired Ethernet during setup avoids Wi-Fi headaches. If you'll rely on Wi-Fi later, it's worth reading up on a stable smart-home Wi-Fi setup first.
If you're still deciding whether this project is for you, our overview of what Home Assistant is and who should use it is a good starting point.
Step 1: Choose your installation method
Home Assistant offers several install types, but for a dedicated Raspberry Pi, the official recommendation is Home Assistant Operating System (HAOS). It's a purpose-built OS that bundles the Supervisor, the Add-on Store, and a managed update and backup system. The alternative — installing Home Assistant Container or Core on top of Raspberry Pi OS — gives more flexibility but takes away the one-click add-ons and managed updates that make a Pi pleasant to live with.
- Easiest to maintain; managed updates and backups
- Full Add-on Store (one-click extras)
- Best for a dedicated Pi
- More flexible; runs alongside other software
- No Supervisor, so no built-in Add-on Store
- Best if the Pi already has another job
Step 2: Flash Home Assistant OS to your storage
The simplest path uses the official Raspberry Pi Imager, which can download and write the Home Assistant image for you.
- 1Install and open Raspberry Pi Imager on your computer
- 2Choose your Pi model, then pick Home Assistant OS under “Other specific-purpose OS”
- 3Select your SSD or SD card and write the image
- Download and install the Raspberry Pi Imager from raspberrypi.com on your main computer.
- Open it and select your device (for example, Raspberry Pi 5).
- Under "Choose OS," navigate to Other specific-purpose OS → Home Assistants and home automation → Home Assistant, and pick the image that matches your board.
- Select your storage (the SSD or SD card), then click Write. Double-check you've selected the correct drive — this erases it.
Step 3: Boot the Pi and wait for first start
Insert the flashed storage, connect the Ethernet cable, and plug in power last. On first boot, Home Assistant downloads the latest version and prepares the system, which can take several minutes — sometimes up to 20. Don't pull the power during this stage, even if it looks idle.
Step 4: Onboard in your browser
Once the Pi has settled, open a browser on a device on the same network and go to:
http://homeassistant.local:8123
If that address doesn't resolve (some networks block the .local mDNS lookup), find the Pi's IP address in your router's device list and use http://<ip-address>:8123 instead. From here you'll:
- Create your administrator account (this is stored locally on the Pi, not in the cloud).
- Set your home's name, location, and unit preferences — location enables sun-based and weather automations.
- Let Home Assistant auto-discover devices already on your network. It's normal for it to surface smart speakers, TVs, and printers right away.
Step 5: Back up immediately, then expand
Before you invest hours building dashboards and automations, set up backups. Home Assistant can create full snapshots from its Settings area, and you should store at least one copy off the Pi — on a NAS, cloud storage, or your computer. If the storage ever fails, a recent backup restores your entire setup in minutes.
With the foundation in place, you can start adding integrations. Many modern devices join over Matter and Thread; if you're weighing protocols, see Matter vs Zigbee vs Z-Wave. Thread devices need a border router on your network — and you may already own one. To add Zigbee or Z-Wave directly to the Pi, you'll plug in a compatible USB radio and enable the matching integration.
Keeping it stable
A Pi-based hub is reliable when a few basics are right. Most instability traces back to power, storage, or network rather than Home Assistant itself.
- Underpowering causes the most baffling crashes — use the official supply and avoid powering hungry USB devices off the Pi without a powered hub.
- SD-card wear shows up as corruption or a hub that won't boot. Moving to an SSD is the durable fix.
- Network drops can make the hub look dead when it's only unreachable. If yours keeps dropping off, our guide on stabilizing a hub that keeps disconnecting walks through the usual culprits.
Still deciding whether a dedicated hub is even necessary? Our 2026 guide to whether you still need a smart-home hub covers the trade-offs.
Frequently asked questions
Can I run Home Assistant on a Raspberry Pi Zero?
It's not recommended. The Zero and Zero 2 W lack the RAM and processing headroom for a smooth experience, and the official guidance points to the Pi 4 or 5. A low-powered board often leads to slow dashboards and timeouts that look like bugs but are really hardware limits.
Do I need internet access for it to work?
Core local control works without internet — that's a major reason people choose Home Assistant. You'll want internet for the initial download, updates, and any cloud-connected integrations or remote access, but local automations keep running during an outage.
SD card or SSD — does it really matter?
Yes. Home Assistant writes to storage constantly (logs, history, the database), and consumer SD cards aren't built for that endurance. A USB SSD or NVMe drive is far less likely to corrupt and noticeably faster. If you only have an SD card, use a reputable high-endurance model and back up often.
Can I move my setup to a different Pi later?
Yes. Because everything is captured in a full backup, you can flash HAOS onto new hardware and restore your backup to migrate your entire configuration, integrations, and history with minimal fuss.
