Power-User · Level 3 of 3
Setting up Home Assistant on a Raspberry Pi means buying a Pi with at least 2GB of RAM, flashing Home Assistant OS onto an SD card or SSD with the free Raspberry Pi Imager, booting the board, and completing a short account wizard in your browser. Once the hardware is in hand, the whole process takes about 30 minutes and does not require writing any code. This guide covers the setup end to end: what to buy and what it costs right now, the SD-card-versus-SSD decision that actually affects reliability, the exact flashing steps, and the first integration to add once the dashboard loads.
Home Assistant itself is free, open-source software that runs your smart-home automations locally instead of in a vendor’s cloud. It needs a small, always-on computer to live on, and a Raspberry Pi is the most common choice because it is inexpensive, well documented, and officially supported by the Home Assistant project. If a spare Pi 4 or Pi 5 is already sitting in a drawer, this is a good use for it.
What to buy: the shopping list (and what it actually costs)
Home Assistant OS runs on a Raspberry Pi 4 or 5 with at least 2GB of RAM. A Raspberry Pi 5 is faster and is the board Home Assistant recommends for new setups, but a spare Pi 4 handles a typical house without trouble. The full list:
- A Raspberry Pi 4 or 5 (2GB RAM minimum) with its matching power supply. A Pi 5 needs the official 27W USB-C supply — a phone charger or a laptop’s USB port will not deliver enough power and causes random reboots under load.
- Storage: either a microSD card (32GB minimum, Application Class 2 / “A2” rated) or a USB or PCIe SSD. See the reliability section below before deciding.
- An Ethernet cable. Home Assistant supports Wi-Fi after setup, but Ethernet is required for the initial install and stays the more reliable connection for a device meant to run unattended.
- A case (optional but recommended). A Pi 5 runs hot enough under sustained load that Raspberry Pi recommends active cooling, and the official case includes a fan.
Pricing is the one part of this list that has moved recently. A global memory shortage pushed Raspberry Pi to raise board prices more than once since late 2025, and by February 2026 the increases reached $15 more on the 4GB Pi 5 and $30 more on the 8GB model compared to 2025 list prices, with resellers reporting different street prices week to week during the shortage. The only reliably current number is on Raspberry Pi’s own product page, which lists the 16GB model at $305 and holds the entry 1GB model at $45 as of this writing. Check the current price there before buying, budget somewhat more than older reviews suggest, and add storage, a cable, a case, and a power supply on top — realistically another $20 to $60 depending on what’s already on hand.
SD card or SSD? The reliability trade-off
Home Assistant writes to its database constantly: every sensor update, every automation run, every state change gets logged. A microSD card can run that workload, but consumer SD cards are not built for constant small writes, and the Home Assistant community has documented card failures for years, even with high-endurance cards. An SSD connected over USB 3 or, on a Pi 5, PCIe uses wear leveling to spread those writes across the whole drive and carries a write-endurance rating far higher than any SD card, so it holds up to the same workload for much longer.
| MicroSD card | SSD (USB or PCIe) | |
|---|---|---|
| Upfront cost | Lower | Higher |
| Write endurance | Weakest link in the setup | Built for constant writes |
| Setup complexity | Plug in and flash | Occasional EEPROM boot-order step on a first NVMe boot |
| Good enough for | A test build or a short trial | Anything meant to run for years |
A card is a reasonable way to try Home Assistant over a weekend. For a setup meant to run unattended for years, plan to move storage to an SSD, either from day one or the first time a card starts acting up. Both routes flash the same way in Raspberry Pi Imager, so switching later is a re-flash, not a rebuild, which makes a card the good-enough option to start with if that’s what’s already on hand.
How to flash Home Assistant OS with Raspberry Pi Imager
This is the only part of the setup that needs a second computer — a Windows, Mac, or Linux machine with an SD card slot or a USB adapter. The steps below follow Home Assistant’s official installation guide.
- Install the free Raspberry Pi Imager from raspberrypi.com/software on your computer.
- Insert the SD card or SSD into the computer. Anything already on it will be overwritten, so back it up first if it holds other data.
- Open Raspberry Pi Imager and select Choose OS.
- Choose Other specific-purpose OS → Home automation → Home Assistant.
- Pick the Home Assistant OS image that matches the board — Raspberry Pi 4 and 5 use separate images, and using the wrong one is the most common reason a fresh install won’t boot.
- Select Choose Storage and pick the SD card or SSD.
- Select Next, then Write, and wait. Writing and verifying the image takes several minutes depending on the storage’s speed.
- When it finishes, eject the storage and move it to the Pi.
Booting it up and reaching the dashboard
Insert the SD card or connect the SSD, plug in an Ethernet cable connected to the same network as your computer, then connect power last. Home Assistant OS needs a few minutes to finish its own first-boot process and download the current Home Assistant Core, roughly 700MB, so leave it alone even if nothing appears to happen right away.
Open a browser on the computer and go to homeassistant.local:8123. If that address does not resolve — this happens on some older Windows setups and locked-down networks — try homeassistant:8123, or find the Pi’s IP address from the router and use http://[that IP]:8123 instead. If nothing loads after five minutes, the image likely did not write cleanly; re-flash it, ideally onto a different card, and try again.
Creating a Home Assistant account
The onboarding wizard runs entirely in the browser and takes a few minutes, following Home Assistant’s own onboarding steps:
- On the welcome screen, select Create my smart home to start a new installation (choose restore from backup instead when moving an existing setup to new hardware).
- Enter a name, a lowercase username with no spaces, and a password, then select Create account. This becomes the owner account, and Home Assistant has no password-reset flow for it, so store the credentials somewhere they’ll actually be found again.
- Enter the home’s location. Home Assistant uses it to set the time zone, unit system, and currency, and to build a “home” zone that automations can trigger on, such as porch lights at sunset.
- Choose whether to share anonymized usage data, then select Next. This is optional and off by default.
- Select Finish to land on the default dashboard.
Adding the first integration
Home Assistant auto-discovers many devices on the network the moment it starts, and anything it finds shows up under Settings → Devices & Services → Discovered, ready to add with one click. But the fastest way to confirm the whole setup actually works, with no smart device required, is the Workday integration, which Home Assistant’s own getting-started guide uses for exactly this reason.
- Go to Settings → Devices & Services.
- Select Add integration in the bottom-right corner.
- Type “workday” and select the Workday integration.
- Give it a name, such as “Workday tomorrow,” pick the country, then select Submit and Finish.
- On the options screen, remove any day that isn’t a workday, and set Offset to 1 to check tomorrow instead of today. Select Submit.
- Pick an area, such as “office,” and select Finish.
That’s a working integration with an entity ready to reference in an automation, built without touching a single smart device. From here the pattern repeats for a real device: check Discovered first, then search for the brand or integration by name if it isn’t listed there.
Where this setup breaks
- Dashboard never loads. Usually a bad flash. Re-flash the image, try a different card or USB port, and confirm the Ethernet cable is actually connected to the router, not just the computer.
- Random reboots under load. Almost always an underpowered supply. A Pi 5 needs the official 27W USB-C supply; a phone charger or a laptop USB port cannot reliably deliver 5V/5A.
- Home Assistant gets slower over months. A common symptom of an SD card wearing out from constant writes — the reliability trade-off from earlier catching up with the setup, and the strongest argument for moving to an SSD sooner rather than after.
- Wi-Fi drops during setup. Home Assistant OS requires Ethernet for the initial install; Wi-Fi can be configured afterward from settings, so leave the cable connected until onboarding finishes.
What this actually costs, and who should skip the Pi route
All in, a Raspberry Pi build lands somewhere between $90 and $200 depending on which Pi model gets bought, memory prices at the time, and whether a case, cable, and SSD are already on hand. That buys the most flexible version of Home Assistant available: full control over the hardware, the option to add a Zigbee or Z-Wave radio later, and no vendor tying the software to one specific box.
It is not the only way in. Home Assistant Green is Nabu Casa’s official plug-and-play hub: Home Assistant OS pre-installed on dedicated hardware, ready after connecting power and Ethernet, with no flashing or EEPROM steps involved. It costs more than a bare Pi board alone but skips every step in this guide between unboxing and the account wizard. Buy the Green instead of building a Pi if there isn’t already a spare Pi sitting around, touching Raspberry Pi Imager sounds like a chore, or the hub just needs to work today without the shopping list above.
Where to go next
With a working install and one test integration in place, the next step is deciding which automations to build first, not adding more integrations one at a time. 20 Home Assistant automations worth setting up first walks through the highest-payoff ones in order, starting with the same motion-light pattern the Workday integration above stands in for. For anyone still weighing whether the ongoing setup and maintenance is worth it against a simpler ecosystem, is Home Assistant worth it? breaks down the real cost and effort against the alternatives.
Evidence and verification
Last verified: July 18, 2026. Installation and onboarding steps were checked against Home Assistant’s official documentation for Raspberry Pi installation, onboarding, and adding integrations. Raspberry Pi pricing was checked against Raspberry Pi’s own product page and its February 2026 pricing announcement; board prices have moved more than once since late 2025 due to a memory shortage, so confirm the current price before buying. SD-card-versus-SSD reliability reflects widely documented community experience with Home Assistant’s default database rather than a single official recommendation posted as one page — treat it as strong, consistent consensus, not a manufacturer spec.