Home Assistant is the most popular open-source smart home platform in the world — and your Raspberry Pi is the perfect hardware to run it. In this guide, we'll walk you through a complete setup from a fresh SD card to a fully working dashboard.
What You'll Need
🔧 Parts List
- Raspberry Pi 4 (2GB RAM minimum) — Pi 3B+ also works but slower
- MicroSD Card (32GB+) — Class 10 or faster recommended
- 5V/3A USB-C Power Supply — use official Pi power supply
- Ethernet cable or WiFi — Ethernet recommended for stability
- Raspberry Pi Imager — free download from raspberrypi.com
Step 1: Flash Home Assistant OS
The easiest way to install Home Assistant is using the official Home Assistant OS (HAOS) image. This gives you a complete, optimized system.
- 1
Download Raspberry Pi Imager
Go to raspberrypi.com/software and download the Imager for your OS (Windows/Mac/Linux).
- 2
Select Home Assistant OS
Open Imager → "Choose OS" → "Other specific-purpose OS" → "Home assistants and home automation" → "Home Assistant OS".
- 3
Flash the SD Card
Select your SD card, click Write, and wait 5–10 minutes for the flash to complete.
Step 2: First Boot Setup
Set a static IP address for your Pi in your router settings (DHCP reservation). This ensures the Home Assistant URL never changes.
Step 3: Install Your First Integration
Home Assistant has 3,000+ integrations. Let's start with smart lights using the Philips Hue integration:
# Configuration for Philips Hue
light:
- platform: hue
host: 192.168.1.2
allow_unreachable: true
Step 4: Create Your First Automation
Now let's create a simple automation: turn on the living room lights at sunset.
# automations.yaml
- id: sunset_lights
alias: "Turn on lights at sunset"
trigger:
- platform: sun
event: sunset
action:
- service: light.turn_on
target:
entity_id: light.living_room
data:
brightness: 200
Always create a Home Assistant backup before updating. Go to Settings → System → Backups → Create Backup.