For: anyone with a few smart devices. Time: about an hour, plus a wait while it sets itself up. Difficulty: easy to start, deep if you want it.
What is Home Assistant?
Home Assistant (HA) is free, open-source software that acts as the brain of your smart home. It runs on a small computer in your house.
Most smart devices come with their own app. Your lights have one, your heating another, your speakers a third. HA puts them all in one place, and lets them work together.
What is it for?
- One app for everything. Lights, plugs, heating, cameras, speakers and sensors from different brands, side by side.
- Automations. "When the front door opens after dark, turn the hall light on." "If the washing machine stops, send me a message."
- Local control. Many things keep working even if the internet drops, because HA talks to devices inside your home.
- Privacy. Your data stays on your own hardware, not on a company's servers.
- Dashboards. A screen showing what you care about: energy use, who's home, temperatures.
- Keeping devices useful. If a manufacturer closes its app, HA can often keep the device working.
Is it for you?
HA suits you if you like tinkering a little and have, or plan to have, several smart devices. If you only have one smart plug, the plug's own app is fine.
Words you'll hear
- Integration: a plug-in that lets HA talk to a brand or protocol (Hue, Sonos, Tapo and so on).
- Device and entity: a device is the physical thing. Entities are its parts, like a temperature reading or an on/off switch.
- Area: a room, like Kitchen or Bedroom.
- Automation: a rule with a trigger, optional conditions, and an action.
- Add-on: an extra app that runs next to HA (only on Home Assistant OS).
Step 1: Choose the hardware
- Home Assistant Green: a ready-made, plug-in box from the HA project. The easiest start.
- Raspberry Pi 4 or 5: the popular choice. Add a good power supply and, ideally, an SSD. HA writes to storage constantly, and cheap SD cards wear out.
- A mini PC: more power, handy if you'll run other things too.
Whatever you pick, plug it into your router with an Ethernet cable for the first set-up. It's more reliable than Wi-Fi.
Step 2: Install Home Assistant OS
This is the recommended way for beginners. It includes everything, including add-ons.
- On your computer, install Raspberry Pi Imager (free, from raspberrypi.com).
- Choose your device, then click OS, then Other specific-purpose OS, then Home automation, then Home Assistant. Pick the image for your board (Pi 4 or Pi 5).
- Choose your SD card or SSD and write it. This erases it.
- Put it in your Pi, plug in the Ethernet cable and power.
- Wait a few minutes. The official guide says it should appear within about a minute on a Pi 4 or 5. If nothing shows after 5 minutes, write the card again, or try a different card.
(Home Assistant Green is ready to go: plug it in and wait.)
Step 3: Open it
On a computer or phone on the same network, go to http://homeassistant.local:8123 (the official page also accepts homeassistant.local on its own). If that doesn't work, find the device's address in your router's device list and use http://ADDRESS:8123.
Step 4: Create your account
- Create the owner account with a long, unique password.
- Name your home and set your location, time zone and units.
- HA will show devices it has found on your network. Add the ones you recognise.
Step 5: Add your devices
- Go to Settings, then Devices & services.
- Check what's been discovered, and click Add integration for anything missing.
- Give each device a sensible name and put it in an area.
Some devices need extras. Zigbee gadgets usually need a small USB Zigbee adapter. Many newer devices support Matter, which makes pairing simpler.
Step 6: Make your first automation
- Go to Settings, then Automations & scenes, then Create automation.
- Pick a trigger. For example, Sun: sunset.
- Pick an action. For example, turn on a lamp.
- Save it, and test it.
Start with something small and obvious. Add complexity later.
Step 7: Keep it safe
- Turn on two-step login: open your profile (bottom left), go to Security, and under Multi-factor authentication modules select Enable for the authenticator app. Scan the QR code, then type in the six-digit code.
- Do not forward port 8123 from your router. Anyone on the internet could then reach your login page. To use HA away from home, use a private tunnel such as Tailscale, or the paid Home Assistant Cloud subscription.
- Install updates when HA offers them, but read the release notes first. They sometimes note changes that can break things.
- Set up backups: Settings, then System, then Backups. Copy a backup to another device or cloud storage. Follow the 3-2-1 rule.
The skull-dog says: Smart home kit is chatty and often poorly updated. HA is a good way to keep it under your control. But it can switch on your heating and unlock your doors, so treat its login like your front-door key.
Step 8: Tidy up your network (optional)
Smart gadgets are a good use for a separate network. See Give gadgets and guests their own network. Some devices need to be on the same network as HA to be found, so test after changing things.
Quick checklist
Common beginner mistakes
- Using Wi-Fi for the HA box. It works, but it's less reliable.
- Cheap SD card. Use a good one or an SSD.
- Exposing HA to the internet. Use a private tunnel.
- Updating without a backup. Back up first.
- Starting too big. Get one room working, then grow.