A Raspberry Pi is a small, quiet and energy-efficient foundation for a local smart home. This guide installs Home Assistant Operating System (HAOS) directly on a Pi. You do not first need Raspberry Pi OS, Docker or Python. The steps assume the Pi is dedicated to Home Assistant.
HAOS includes Home Assistant Core, the Supervisor for updates and management, installable apps, and backup, recovery and hardware management in one interface. Many functions continue to run locally without internet. Home Assistant Container can also run on a Pi, but you then deliberately manage Docker and Linux yourself; that is not this beginner route.
1. Choose your hardware
If you already have a Raspberry Pi 4 with 4 GB of memory, keep using it. For a new setup, a Raspberry Pi 5 with 4 GB, an official or good-quality 27 W power supply, active cooling and Ethernet is a strong starting point. The installation guide lists Pi 4 and 5 with at least 2 GB RAM. A suitable quality 15 W supply is appropriate for a Pi 4.
Start with an A2 microSD card of at least 32 GB; 64 GB gives more headroom if you stay entirely on SD. A 128–256 GB SSD or NVMe drive as a later data disk is recommended for history, the database and apps. Zigbee needs a separate radio, such as Home Assistant Connect ZBT-2. Assign it to Zigbee or Thread, not both at once.
| Component | Minimum | Recommended | Why |
|---|---|---|---|
| Raspberry Pi | Pi 4/5 with 2 GB | Pi 4 or 5 with 4 GB | Headroom for dashboards, integrations and a few apps without overkill. |
| Power | Supply suitable for the Pi | Quality 15 W for Pi 4; 5 V/5 A or official 27 W for Pi 5 | Insufficient power can cause unexplained failures. |
| Cooling | Suitable for installation | Active cooling for Pi 5 | Helps performance and stability under load. |
| microSD | 32 GB A2 | 32–64 GB A2 | A2 is better suited to many small reads and writes. |
| Network | Ethernet for installation | Ethernet permanently | Reliable link for the central hub. |
| Data storage | microSD | SSD/NVMe data disk | Faster, more robust storage for database, history and apps. |
| Zigbee | Optional | Connect ZBT-2 for a new network | Separate coordinator for Zigbee devices. |
2. Decide how to store your data
Using only microSD is the simplest start and can work for a modest installation. Set up automatic backups and keep a copy outside the Pi. My preferred setup is microSD for booting and SSD/NVMe for Home Assistant data. The external data disk must be larger than the existing boot drive. Moving data erases the target SSD completely: select carefully and make a full backup first.
Recorder, history, logs and apps create many small writes. The external data disk contains not only the database but also Core and apps, so faster storage can noticeably help. For the Pi 5, SD boot with NVMe as the data disk is a reliable route. Direct USB boot can work on some Pi models but brings additional compatibility risk. A 32 GB microSD with a 128 or 256 GB SSD is a straightforward pairing.
3. Write Home Assistant OS to microSD
- Install Raspberry Pi Imager on a computer and insert the microSD card in a reader.
- Select your Pi model. Then choose Other specific-purpose OS → Home automation → Home Assistant and the HAOS image for your Pi.
- Select the microSD as the target. Double-check the drive: Imager overwrites its contents.
- Choose Write, let writing and verification finish, then safely eject the card.
Home Assistant also provides direct .img.xz images; Balena Etcher is an alternative if Pi Imager is unavailable.
4. Start the Pi for the first time
Insert the microSD, connect Ethernet, check the cooling and connect power last. Wait a few minutes: first boot can take longer while Home Assistant downloads components. For a new installation, first open http://homeassistant.local/. If it fails, find the Pi’s IP address in the router and try http://<Pi-IP-address>/. New Home Assistant OS installations use port 80 by default since 2026.8. If that fails, try http://<Pi-IP-address>:8123/, for example if port 80 is occupied or the installation uses an older configuration. Check Ethernet, DHCP, startup status, and the local console when needed. Once connected, inspect the actual port under Settings → System → Network → HTTP server.
Perform the first setup where you can easily reach the card, cables and power supply. If the Pi remains unreachable after around five minutes, reflash the card or try another microSD. Temporarily connect HDMI and a keyboard to inspect the local console if further diagnosis is needed; neither is needed for normal use.
5. Complete initial setup
Create the first owner account in the browser and store its credentials safely. Set the correct location and time zone; they matter for sun-based and presence automations. Choose whether you want to share anonymous analytics. Then update Home Assistant OS, Core and apps via Settings → System → Updates.
Select Create my smart home during onboarding. The owner account cannot simply be recovered through an email reset. Location also determines units, currency and the Home zone. No terminal or YAML is required for these steps.
6. Optionally move data to SSD/NVMe
First create a full backup and download it to another computer. Connect the SSD or NVMe drive, open Settings → System → Storage → Move data disk, select the correct drive and confirm. The system may restart during the move. Afterwards, check Storage to confirm the data disk is active. A Pi 5 can use NVMe through an M.2 HAT+; a USB SSD is common with a Pi 4.
Allow the move to complete; it may take some time. The target disk is erased, so check the selected drive before pressing Move.
7. Add Zigbee
A Pi has no built-in Zigbee radio. Position the coordinator away from the Pi, SSD, USB 3.0 hardware and Wi-Fi access point; a short USB extension cable helps reduce interference. Prefer a USB 2.0 port. A ZBT-2 can provide Zigbee or Thread, but not both simultaneously.
The earlier Connect ZBT-1/SkyConnect remains supported. Third-party options include the Sonoff Zigbee 3.0 USB Dongle Plus ZBDongle-E. This setup uses the ZBT-2 for Zigbee. Zigbee is a mesh network: permanently powered devices can extend coverage.
Connect the adapter. If it is discovered automatically, choose Setup under Settings → Devices & services. Otherwise choose Add integration → Zigbee Home Automation (ZHA). Add a lamp, sensor or plug via Settings → Connectivity → Zigbee → Add device, then put the device in pairing mode. Start with a few mains-powered Zigbee devices that can act as mesh routers.
Restart Home Assistant if the adapter is not visible. In the ZHA wizard, select the serial adapter belonging to the coordinator; Home Assistant attempts to detect its radio type. After configuration, find the network under Settings → Connectivity → Zigbee. Put the first device in pairing mode or factory-reset it as its manual describes, then assign its name and area when found. ZHA is a good starting point; you need not learn Zigbee2MQTT for the first network.
8. Make the installation reliable
Set up automatic backups with at least one external copy. Consider reserving a stable DHCP address in your router. Add devices gradually so you can trace problems. Change the Zigbee channel only if there is clear interference; do not disable safety or essential functions for convenience.
If something does not work
- No page loads: find the Pi’s IP address in the router and try
http://<Pi-IP-address>/. If that fails, tryhttp://<Pi-IP-address>:8123/; check Ethernet, DHCP and the local console when needed. - Pi does not start: check power, microSD and cooling; reflash or try another card.
- Zigbee devices drop out: move the radio farther from Pi/SSD/Wi-Fi, use USB 2.0 and improve the mesh.
- SSD is missing: check cable, adapter, power and target-drive capacity.
- Home Assistant feels slow: check storage, database and history; an SSD/NVMe data disk helps especially with history and apps.
- Problems after an update: restore from the external backup.
Three sensible hardware setups
The least expensive start: Pi 4 with 2 or 4 GB, quality 15 W USB-C supply, 64 GB A2 microSD, simple case/heatsinks and Ethernet. Add Zigbee later. This is good for learning Home Assistant, but the microSD makes external backups particularly important.
A new system: Pi 5 with 4 GB, official or quality 27 W USB-C supply, active cooling, 32 or 64 GB A2 microSD for booting, 128–256 GB NVMe via M.2 HAT+ or SSD as data disk, Gigabit Ethernet and a freely positioned Connect ZBT-2 for Zigbee.
Keep an existing Pi 4: a Pi 4 with 4 GB and a good SSD remains useful. Spend on reliable storage, power, backups and a good Zigbee coordinator rather than replacing it unnecessarily.
Official documentation
- Home Assistant: Raspberry Pi installation
- Home Assistant: external data disk
- Home Assistant: Zigbee Home Automation
- Home Assistant Connect ZBT-2
- Raspberry Pi documentation
- Home Assistant: installation types
- Home Assistant: onboarding
- Home Assistant: Pi 5 support and NVMe
- Raspberry Pi 5
- Raspberry Pi M.2 HAT+
The referenced documentation was checked on 26 September 2026. Menu names may change in later Home Assistant versions.
