About meContact

How to install Home Assistant on Raspberry Pi 4 and 5

This guide takes you from choosing the hardware and writing Home Assistant OS to a microSD card through first login, basic security and your first backup. It covers Raspberry Pi 4 and Raspberry Pi 5 used primarily as a Home Assistant server.

Home Assistant OS is written directly to the card. Do not install Raspberry Pi OS first and do not use apt commands. Writing the image erases everything already stored on the selected device. This guide covers Home Assistant OS, not an installation in Docker or on Raspberry Pi OS.

Is Raspberry Pi a good choice?

A Raspberry Pi 4 or 5 is a sensible starting point and is sufficient for many normal installations. If you already own either model, you do not need to buy an expensive server before you begin.

A larger system with many apps, a substantial database, monitoring or extra services may eventually justify a mini PC. Raspberry Pi is not the best platform for everyone, but it is a straightforward, officially supported route into Home Assistant.

What will you need?

Official minimum

  • Raspberry Pi 4 or Raspberry Pi 5 with at least 2 GB RAM,
  • the correct power supply for that model,
  • a microSD card of at least 32 GB, preferably A2,
  • a microSD card reader,
  • an Ethernet cable,
  • a Windows, macOS or Linux computer.

HA Expert practical recommendation

  • 4 GB RAM as a sensible choice for a typical system,
  • a reputable A2 or high-endurance card,
  • a case and adequate cooling, especially for Pi 5,
  • a stable wired network connection,
  • regular backups stored away from the Raspberry Pi.

4 GB is not the official minimum. It is a practical recommendation that leaves room to expand.

microSD card or SSD?

The simplest official starting procedure uses a microSD card. A good A2 card is enough to get started. There is no honest universal lifespan figure: card quality, power stability and write activity all matter.

Faster, more durable storage may be worthwhile in a system that runs continuously and writes a lot of data. An SSD can be a sensible upgrade, but it requires compatible hardware and configuration. This main procedure uses microSD to keep a first installation uncomplicated.

Download Raspberry Pi Imager

  1. Go to the official Raspberry Pi Imager page.
  2. Download and install the version for your computer.
  3. Insert the microSD card into a reader connected to the computer.
  4. Copy away any files you need from that card before continuing.

Warning: the selected storage device will be erased. Check its name and capacity before writing.

Write Home Assistant OS to the card

  1. Open Raspberry Pi Imager and choose Raspberry Pi 4 or Raspberry Pi 5 as the device.
  2. Choose the operating system and open Other specific-purpose OS → Home automation → Home Assistant.
  3. Select the Home Assistant OS image made for your exact Pi model.
  4. Choose the microSD card as storage and verify its name and capacity again.
  5. Select Next, then Write, and confirm that the card may be erased.
  6. Wait for writing and verification to finish. Select Finish, then eject the card safely.

Raspberry Pi OS account, SSH and Raspberry Pi OS customisation options are not part of HAOS. Do not configure an operating-system account that will not exist. If Imager does not work, obtain the current image from the official Home Assistant installation page and use a compatible writer such as Balena Etcher. Do not rely on a fixed release link.

First boot of the Raspberry Pi

  1. Disconnect power from the Raspberry Pi.
  2. Insert the prepared microSD card.
  3. Connect Ethernet to your router or switch and ensure that the network has internet access.
  4. Only then connect the correct power supply.
  5. Do not power the device off while the system is being prepared.

The first boot prepares and downloads required components. Its duration depends on the Pi, card and network, so do not expect a fixed time or cut the power merely because the preparation screen remains visible.

Open Home Assistant in a browser

On a computer or phone connected to the same network, try these addresses in order:

  • http://homeassistant.local:8123
  • http://homeassistant:8123
  • http://192.168.x.x:8123 after replacing the example with the Pi’s IP address.

Find the IP address in your router’s DHCP client or connected-device list. It is the local address assigned to the Pi. Use http:// for the initial local connection; https:// becomes available only after you configure encryption or a secure remote service.

Initial setup – onboarding

  1. On the welcome screen, create a new installation. If you are migrating, you can upload a compatible backup instead.
  2. Create the owner account. The display name identifies the person in the interface; the username is used to sign in and must use lower-case letters without spaces.
  3. Choose a strong, unique password and store the credentials in a secure password manager. Do not assume that owner credentials will be easy to recover.
  4. Set your home location and check the time zone, unit system and currency.
  5. Choose whether to share anonymous analytics.
  6. Complete the wizard. The main dashboard will appear after the discovery stage.

Five things to do immediately

  1. Check updates. Review updates shown for Home Assistant Core, Supervisor, HAOS and installed apps.
  2. Configure automatic backups. Go to Settings → System → Backups, set a schedule, download the emergency kit containing the recovery key and keep at least one copy away from the Pi.
  3. Create a DHCP reservation. Reserve the Pi’s address in the router. This is usually simpler for a beginner than manually assigning a static address in the operating system.
  4. Add your first devices. Continue with the Home Assistant integrations guide.
  5. Plan secure remote access. Do not expose plain port 8123 directly to the internet. Home Assistant Cloud or a properly configured VPN are safer beginner-friendly approaches.

Common installation problems

homeassistant.local does not open

Check power and LEDs, both Ethernet ends, internet access and whether your computer is on the same network. Try homeassistant:8123 and the IP from your router. If the Pi is absent from DHCP, rewrite the image, try another card and finally connect an HDMI display to read boot messages.

The Raspberry Pi does not boot

Check the power supply, whether the image matches Pi 4 or Pi 5, and whether storage verification passed. Rewrite the card and make sure you did not choose an image for another model.

“Preparing Home Assistant” takes a long time

Do not immediately disconnect power. The first boot needs internet access. Check DHCP, DNS, internet access and time synchronisation. If it still does not respond, locate its IP and follow the official troubleshooting guide.

Imager does not list Home Assistant

Update Raspberry Pi Imager and check the specific-purpose OS category again. Alternatively, download the current official HAOS image and use a compatible writing tool.

What should you do next?

Frequently asked questions

Is Raspberry Pi 4 enough for Home Assistant?

Yes. It is a sensible platform for many normal installations when paired with the correct power supply, good storage and at least 2 GB RAM.

Should I choose Raspberry Pi 4 or Raspberry Pi 5?

Pi 5 provides more performance headroom but needs appropriate power and cooling. If you already own a Pi 4, it is usually worth starting with it.

How much RAM do I need?

The official minimum is 2 GB. HA Expert’s practical recommendation for a typical growing system is 4 GB; this is not an official requirement.

Can Home Assistant use Wi-Fi?

Yes, but the official initial procedure recommends Ethernet. A wired connection is also easier to troubleshoot.

Must I use a microSD card?

No. microSD is the simplest first-installation route. An SSD can be a later upgrade after checking hardware compatibility.

Do I install Raspberry Pi OS first?

No. Write Home Assistant OS directly to the card; Raspberry Pi OS and apt commands are not required.

What if homeassistant.local does not work?

Try homeassistant:8123 or the IP shown in your router’s DHCP list, and verify Ethernet connectivity.

Can I move the system to different hardware later?

Yes. Home Assistant can restore a backup during onboarding on another device. Keep both the backup and its emergency kit.

Is internet access to Home Assistant safe?

It can be when properly configured. Beginners should not simply forward port 8123; Home Assistant Cloud or a correctly configured VPN is the safer route.

Do you need help installing or configuring Home Assistant?

If Home Assistant starts but you are stuck on integrations, networking, automations, Zigbee or the next configuration step, describe the problem. I will first check whether I can genuinely help and suggest an appropriate scope.

Contact me.The initial assessment of your request is free and without obligation. → click here

Sources and currency

This guide was checked on 11 August 2026 against current official resources: