How to Install Home Assistant: A Beginner's Guide
The simplest way to install Home Assistant as a beginner is to run Home Assistant Operating System (HAOS) on dedicated hardware — most commonly a Raspberry Pi or a small mini-PC. You write the official image to a storage drive, plug the device into your router with an Ethernet cable, power it on, and finish a short browser-based setup. This path gives you the full system, including Add-ons and easy backups, with the least manual work. Below is the why behind each choice, plus the alternatives if you'd rather not buy a separate device.
Step 1: Choose your installation method
Home Assistant offers four installation methods, but they are not equal for beginners. The decision matters because only some methods include the Supervisor, which is what unlocks one-click Add-ons (like a Zigbee or backup add-on) and the simplest update experience.
| Method | What it is | Add-ons & easy updates | Best for |
|---|---|---|---|
| Home Assistant OS | A purpose-built OS that runs only Home Assistant | Yes | Beginners (recommended) |
| Home Assistant Container | A Docker container on your own OS | No Add-ons | Existing Docker/NAS users |
| Home Assistant Supervised | Core + Supervisor on Debian you manage | Yes | Advanced, self-maintained |
| Home Assistant Core | The Python app in a virtual environment | No | Developers only |
For a first install, choose Home Assistant OS. It removes the maintenance burden of an underlying operating system and gives you the complete feature set. If you want the longer reasoning on whether the platform fits you at all, see What Is Home Assistant, and Should You Use It?
Step 2: Pick your hardware
Home Assistant OS runs on several device types. The main trade-off is cost versus performance and storage reliability.
- Raspberry Pi 4 or 5: The classic starting point. Affordable and well-documented. Pair it with an SSD rather than a microSD card — cards wear out under Home Assistant's frequent database writes, a leading cause of corruption months later. Our Home Assistant on Raspberry Pi setup guide walks through this in detail.
- Home Assistant Green: An official plug-and-play box. It arrives ready to run, which sidesteps the flashing step entirely — a good option if you'd rather not assemble anything.
- A mini-PC (Intel N100 and similar): More headroom for cameras, voice, and many integrations. It costs more but ages better.
Step 3: Flash Home Assistant OS
If your device didn't come with Home Assistant pre-installed, you'll write the OS image to your storage drive. The official method uses the Home Assistant Installer within the Raspberry Pi Imager (or the standalone Balena Etcher for other hardware), which downloads and writes the correct image without any command line.
- 1Install Raspberry Pi Imager (or Balena Etcher) on your computer
- 2Select your device, then choose Home Assistant OS from the operating-system list
- 3Insert your SSD/microSD, pick it as the target, and write the image
When writing finishes, move the drive into your Home Assistant device.
Step 4: Power on and connect
Plug the device into your router with an Ethernet cable, then connect power. Wired networking is worth it during setup: many first-time problems are actually Wi-Fi reliability issues in disguise, and a wired connection rules them out. You can revisit wireless later if needed.
Give the device a few minutes on first boot — it expands the file system and prepares itself. Then, on a computer or phone on the same network, open a browser and go to:
http://homeassistant.local:8123- If that doesn't resolve, try
http://homeassistant:8123or the device's IP address followed by:8123(find the IP in your router's connected-devices list).
Step 5: Complete onboarding
The browser walks you through a short setup. You'll:
- Create your local administrator account — username and a strong password. This account lives on your device, not in a cloud, so store the password somewhere safe.
- Name your home and set location, time zone, and unit preferences. Location enables sunrise/sunset and weather data later.
- Review the automatic device discovery. Home Assistant scans your network and often finds smart devices, media players, and hubs without any manual entry.
When onboarding ends, you're looking at your dashboard. That's a working Home Assistant install.
Step 6: Add devices and set up your first backup
Now connect things. Open the integrations area and add discovered devices, or search for a brand or protocol. If you're connecting Zigbee or Thread gear, you'll typically plug in a USB radio dongle first; our comparison of ZHA vs Zigbee2MQTT helps you choose how to run it. For ideas on what to connect first, see the best integrations to start with.
Before you invest hours configuring, set up a backup. Home Assistant can create full backups you can restore if hardware fails or an update goes wrong — read Home Assistant Backup and Restore and make your first one today.
Frequently asked questions
Do I need a Raspberry Pi to install Home Assistant?
No. A Pi is popular and affordable, but Home Assistant OS also runs on mini-PCs, certain NAS units, and virtual machines, and the official Home Assistant Green ships ready to use. Any of these works for a beginner; the Pi is simply the most documented starting point.
Can I install Home Assistant without using the command line?
Yes. The recommended Home Assistant OS path is entirely graphical — you flash the image with an imaging tool and finish setup in a web browser. The command line only becomes relevant with the Core or Container methods, which we don't recommend for a first install.
Why can't I reach homeassistant.local:8123?
The most common causes are the device still booting (wait a few minutes), your computer being on a different network or VLAN than the device, or your network not resolving .local names. Try the device's IP address with :8123 instead — you can find it in your router's list of connected devices.
Is Home Assistant free?
The software is free and open source. Your only required cost is hardware to run it on. There's an optional paid cloud subscription that simplifies remote access and voice-assistant linking, but it's not needed to install or use Home Assistant locally.
