How to Set Up Home Assistant

Home Assistant is the most capable smart home platform available to consumers, and it is the only mainstream option that does not require a cloud account to function. It is also more work than opening a consumer app, and it is worth being honest about that before you start.

The good news: the modern installation path is far less painful than it used to be. You can go from an unopened box to a working dashboard in an evening.

Step 1: Choose hardware

Three realistic options:

• Purpose-built appliance. Home Assistant's own Green and Yellow devices, or a similar small box. The easiest path — flash nothing, configure from a browser, and it is designed to run quietly 24/7 on low power. Yellow adds radios for Zigbee and Thread. Best choice for most people.
• A mini PC. More headroom for add-ons and cameras, and more storage options. Slightly more setup, especially around boot media.
• A Raspberry Pi. The traditional entry point. Works well, but use a quality power supply and an SSD rather than a microSD card, which will fail eventually under constant writes.

Whatever you choose, connect it to Ethernet if you can. Wi-Fi is the most common source of mysterious instability in Home Assistant setups.

Step 2: Install Home Assistant OS

1. Write the image to your boot media

   Download the Home Assistant OS image for your hardware and write it to the drive using a flashing tool. This erases the drive, so use a blank one.

2. Boot the device and connect it to your network

   Ethernet is best. Wait a few minutes — the first boot installs and downloads components, and it takes longer than subsequent boots.

3. Open the web interface

   In most cases the device is reachable at a local address like homeassistant.local:8123. If that does not resolve, find the device's IP address in your router's client list and use that with port 8123.

4. Create your owner account

   This is a local account on the device, not a cloud account. Use a real password and store it in your password manager. Set your home location and time zone accurately — automations depend on them.

5. Let it discover devices

   Home Assistant scans your network and offers discovered devices on the integrations page. Accept the ones you recognize. This is where it typically finds smart speakers, TVs, printers and Matter devices.

Step 3: Add your devices

Home Assistant has three broad ways to connect devices:

• Native integrations. Built-in support for thousands of products and platforms. Prefer these — they are maintained and usually local.
• Matter. Add Matter devices directly, and use Home Assistant as a Matter controller. If you have a Thread border router, Home Assistant can share the Thread network with other ecosystems.
• Radios via a dongle or hub. Zigbee and Z-Wave devices need a USB coordinator or a network-attached hub. Add one only if you actually own those devices.

Add devices in small batches and rename them as you go. A Home Assistant install with two hundred devices called switch_2 is technically functional and practically unusable.

Step 4: Build a dashboard that stays useful

The default dashboard shows everything, which is exactly the problem. A good dashboard answers the questions you ask daily, not the ones you ask yearly.

• One view for the whole house with lights, locks and the thermostat. Nothing else.
• One view per room for the rooms you actually control — usually two or three, not all of them.
• One view for status: doors open, leak sensors, battery levels, devices that are offline. This view is boring and it is the one that saves you.

Keep the cards large enough to tap comfortably on a phone. Most people use their Home Assistant dashboard on a phone, not a wall tablet.

Step 5: Write three automations, then stop

Home Assistant's automation editor is powerful enough to build things you will regret. Start with three, using simple trigger-and-action logic:

1. A notification when a door has been open for more than two minutes.
2. Lights at low brightness when motion is detected after 10pm.
3. A notification if a leak sensor detects water, sent to every adult in the house.

Then live with them for a week before adding more. Every automation you add without testing is a future mystery to debug.

Step 6: Turn on backups before you need them

Home Assistant can take automatic backups, and you should enable them on day one. Store them somewhere other than the boot drive — a network share or cloud target. Anyone who has lost a carefully tuned configuration to a dead microSD card becomes religious about this.

Also write down your setup: hardware model, add-ons installed, which devices use which radio. Future you will not remember.

Products mentioned in this guide

Products referenced in this guide, shown with the manufacturer's own photography. We do not publish prices or star ratings — both change faster than any article can be kept accurate.

Frequently asked questions

Note: Compatibility and feature details on this page come from manufacturer documentation and published specifications at the time of writing. Support changes with firmware, so confirm the current details with the manufacturer before you buy.