What you need
- A Raspberry Pi 5 (4 GB or 8 GB) or a Raspberry Pi 4 (4 GB or more). A 2 GB model can run Home Assistant but leaves little room for add-ons. For help choosing, see which Raspberry Pi do I need to run Home Assistant.
- Storage. A microSD card of 32 GB or more with an A2 rating, or an SSD. An SSD is more reliable for a constantly writing system. A Pi 5 can boot from an NVMe drive with the M.2 HAT+.
- The official power supply. The Pi 5 needs a 27 W USB-C supply (5 V, 5 A). The Pi 4 needs a 15 W USB-C supply (5.1 V, 3 A). Underpowered supplies cause random crashes and can damage storage.
- An Ethernet cable to your router.
- A computer with a card reader, to run Raspberry Pi Imager.
- Optional: an Active Cooler or a ventilated case. A Pi 5 runs warm under load.
Step 1: Flash Home Assistant OS
Install Raspberry Pi Imager on your computer, then:
- Choose your Raspberry Pi model.
- Choose the OS, then Other specific-purpose OS, then Home assistants and home automation, then Home Assistant.
- Choose Home Assistant OS for your model.
- Choose your microSD card or SSD as the storage device. Check it twice, because writing the image erases the drive.
- Write the image and wait for it to finish.
Flash Home Assistant OS directly. Don’t install Raspberry Pi OS first, because Home Assistant OS is a complete operating system on its own.
If you prefer, download the haos_rpi5-64 or haos_rpi4-64 image (a .img.xz file) from the Home Assistant website and write it with balenaEtcher. Use the image that matches your model.
Step 2: Boot the Pi
- Remove the card from your computer and insert it into the powered-off Pi, or connect the SSD.
- Connect the Ethernet cable.
- Connect the power supply.
First boot can take up to about 20 minutes while Home Assistant downloads the latest version and shows “Preparing Home Assistant”. Leave it alone during this time, and don’t unplug it.
Step 3: Finish onboarding
On another device on the same network, open http://homeassistant.local:8123 in a browser. If that address doesn’t load, find the Pi’s IP address in your router’s list of connected devices, then use http://<IP-address>:8123.
The onboarding wizard asks you to:
- create your owner account
- set your location, time zone and units
- decide whether to opt in to analytics
- review the devices Home Assistant has found on your network
You can also restore a backup at this step if you’re moving an existing install.
Step 4: Set up backups and tools
Set a backup schedule and send copies off the Pi, to a NAS, to cloud storage through an add-on, or to Home Assistant Cloud. A microSD card can wear out or fail, and a backup stored only on that card is lost with it. Recent versions encrypt backups, so save the encryption key as well.
To edit configuration files, install the File editor or Studio Code Server add-on. Terminal & SSH gives you shell access if you need it.
Step 5: Move to an SSD later
If you started on a microSD card, you can move Home Assistant to an SSD later. See how to move Home Assistant from an SD card to an SSD.
Shutting down safely
Shut down from Settings > System before you unplug the Pi. Pulling the power while it runs can corrupt the card or SSD.
Troubleshooting
- homeassistant.local doesn’t load. Some networks don’t support .local names. Use the Pi’s IP address instead.
- Random restarts or crashes. Check the power supply first. A phone charger often can’t supply enough current for a Pi 5.
- Nothing happens for a long time at first boot. Give it up to 20 minutes. Check that the Ethernet cable is connected and that the network port shows link activity.
- A USB Zigbee or Z-Wave stick is unstable. Plug it into a USB 2.0 port, or use a short USB extension cable to move it away from USB 3 interference.
Is a Raspberry Pi 2 still good?
No. The Raspberry Pi 2 and the Pi Zero 2 W are not suitable for a current Home Assistant install. They are too slow and have too little memory, and Home Assistant no longer supports 32-bit systems. A Pi 4 with 4 GB of RAM or a Pi 5 is the realistic minimum.
Is a Raspberry Pi a computer?
Yes. A Raspberry Pi is a small single-board computer. You don’t need a monitor, a keyboard or Linux experience to run Home Assistant on it. You set it up from a browser on another device, and the Pi runs Home Assistant OS.
Next steps
Once Home Assistant is running, read is Home Assistant beginner friendly? to plan your first devices and automations.