Setting up Home Assistant on a Raspberry Pi is the most popular way to run a local smart home hub. Unlike cloud-dependent solutions, Home Assistant gives you complete control over your devices, automations, and data—all running on hardware you own. This guide walks you through the entire process, from choosing hardware to completing the initial setup.

TL;DR

Flash Home Assistant OS to a microSD card using Raspberry Pi Imager, insert it into your Pi, connect Ethernet and power, then access the web interface at http://homeassistant.local:8123. Complete the onboarding wizard to create your account and configure your location. Your Pi becomes a dedicated Home Assistant hub in about 10 minutes.

What You’ll Need

Before starting, gather these components:

  • Raspberry Pi 4 or 5 (recommended). A Pi 3 works but will be slower. The Pi 4/5 provides smoother performance, especially with multiple integrations and automations.
  • Official power supply for your Pi model. Using the official supply prevents power-related issues that can cause instability.
  • microSD card (32 GB minimum, Class 10 or better). A 64 GB card gives you more room for logs and add-ons, but 32 GB is sufficient for most setups.
  • Ethernet cable (highly recommended). While Wi-Fi works, Ethernet provides more reliable connectivity for a hub that needs to be always available.
  • Computer with an SD card reader to flash the image.

Installing Home Assistant OS

Home Assistant OS is a complete operating system image designed specifically for Home Assistant. Unlike installing Home Assistant on top of a general-purpose OS, this approach gives you a dedicated, optimized system that’s easier to maintain and update.

Step 1: Download Raspberry Pi Imager

Download Raspberry Pi Imager from the official Raspberry Pi website. It’s available for Windows, macOS, and Linux. Install it on your computer—this tool will handle flashing the Home Assistant image to your SD card.

Step 2: Flash Home Assistant OS to Your SD Card

Open Raspberry Pi Imager and follow these steps:

  • Choose device: Click “Choose device” and select your Raspberry Pi model (Pi 3, 4, or 5).
  • Choose OS: Click “Choose OS” → “Other specific-purpose OS” → “Home assistants and home automation” → “Home Assistant OS”. The imager will download the latest version automatically.
  • Choose storage: Click “Choose storage” and select your microSD card. Make sure you select the correct drive—this will erase all data on the card.
  • Write: Click “Write” and confirm. The process takes 5-10 minutes depending on your SD card speed and computer.

Once the write completes, you’ll see a success message. Safely eject the SD card from your computer.

Step 3: Boot Your Raspberry Pi

Insert the microSD card into your Raspberry Pi. Connect an Ethernet cable to your router (recommended for reliability), then connect the power supply. The Pi will boot automatically.

The first boot takes several minutes as Home Assistant initializes. You’ll see the green activity LED blinking as the system sets up. Wait at least 5-10 minutes before trying to access the web interface.

Accessing Home Assistant

After the initial boot, Home Assistant should be accessible on your local network. Try these methods in order:

  • mDNS (easiest): Open your browser and navigate to http://homeassistant.local:8123. This works on most modern operating systems without additional configuration.
  • Direct IP address: If mDNS doesn’t work, find your Pi’s IP address from your router’s admin panel, then use http://<raspberry_pi_ip>:8123. For example, http://192.168.1.100:8123.

If you can’t find the IP address, you can also check your router’s connected devices list or use a network scanner tool.

Initial Setup Wizard

When you first access Home Assistant, you’ll see the onboarding wizard. This guides you through essential configuration:

  • Create an account: Set up your administrator account with a username and secure password. This account has full access to your Home Assistant instance.
  • Set your location: Enter your home address or coordinates. This enables location-based features like sunrise/sunset automations and weather data.
  • Configure time zone: Select your time zone for accurate scheduling and time-based automations.
  • Choose units: Select metric or imperial for temperature, distance, and other measurements.

After completing the wizard, you’ll land on the Home Assistant dashboard. Your Pi is now a dedicated Home Assistant hub, ready for you to add devices and create automations.

Next Steps

With Home Assistant running, you can start building your smart home:

  • Add integrations for your smart devices (lights, sensors, cameras, etc.)
  • Create automations to control devices based on conditions
  • Set up the mobile app for remote access and notifications
  • Explore add-ons for additional functionality (like Node-RED, MQTT brokers, or backup solutions)

For specific automation examples, check out our guide on camera automation with Home Assistant, which shows how to automate cameras based on your presence.

Troubleshooting

Can’t Access the Web Interface

If you can’t reach Home Assistant after 10-15 minutes:

  • Verify the Ethernet cable is connected and your router shows the Pi as a connected device
  • Check that you’re using the correct IP address or that mDNS is working on your network
  • Try accessing from a different device or browser
  • Ensure your computer and Pi are on the same network

Slow Performance

If Home Assistant feels sluggish:

  • Use a faster microSD card (Class 10 or better, or consider an A2-rated card)
  • Ensure you’re using the official power supply—insufficient power causes throttling
  • Consider upgrading to a Pi 4 or 5 if you’re using a Pi 3
  • Check system resources in Settings → System → Hardware to see if you’re hitting limits

Why Raspberry Pi for Home Assistant?

A Raspberry Pi is an ideal platform for Home Assistant because it’s affordable, energy-efficient, and powerful enough for most smart home setups. It runs 24/7 without significant power consumption, and Home Assistant OS is optimized specifically for Pi hardware, making it reliable and easy to maintain.

For larger setups with many devices and complex automations, you might eventually consider more powerful hardware, but a Raspberry Pi 4 or 5 will handle most home automation needs perfectly.