How to Install Home Assistant OS on Mini PC

This article contains affiliate links. If you purchase through our links, we may earn a commission at no extra cost to you. We only recommend products we’ve thoroughly researched and verified.

Home Assistant OS on a mini PC delivers the best Home Assistant experience available — faster than Raspberry Pi, more reliable than SD cards, and more capable than any dedicated HA hardware. This guide walks you through the complete installation, from preparing your USB drive to your first dashboard.

Time required: 20-30 minutes
Difficulty: Beginner

---

What You Need

Hardware:

• Mini PC with at least 4GB RAM 16GB recommended and 32GB internal storage
• USB drive, 8GB or larger
• USB keyboard for initial BIOS access
• Display connected to the mini PC

Software free:

• Balena Etcher USB flashing tool
• Home Assistant OS generic-x86-64 image

Recommended mini PCs for HAOS:

---

Step 1: Download Home Assistant OS

1. Go to home-assistant.io/installation/
2. Select “Generic x86-64” as your installation target
3. Click “Download HAOS image” — download the .img.xz file
4. Also download Balena Etcher from balena.io/etcher

The HAOS image file is about 800MB-1GB compressed.

---

Step 2: Flash HAOS to USB Drive

1. Insert your USB drive anything currently on it will be erased
2. Open Balena Etcher
3. Click “Flash from file” → select the .img.xz HAOS image
4. Click “Select target” → select your USB drive
5. Click “Flash!”
6. Wait for flashing to complete 3-5 minutes

---

Step 3: Configure BIOS

Your mini PC needs to boot from USB. Access BIOS by pressing the boot key immediately after powering on:

In BIOS, make these changes:

1. Boot order: Set USB drive as first boot device
2. Secure Boot: Disable HAOS does not support Secure Boot
3. Fast Boot: Disable allows USB boot
4. Save and exit F10 on most systems

If BIOS shows a Secure Boot option, ensure it’s set to Disabled or Other OS mode.

---

Step 4: Install HAOS to the Internal Drive

1. Power off the mini PC
2. Insert the HAOS USB drive
3. Power on — the mini PC boots from USB automatically if BIOS is configured correctly
4. A blue progress screen appears: “Installing Home Assistant”
5. The installer automatically copies HAOS to the internal NVMe drive
6. Installation takes 3-5 minutes
7. The system automatically reboots when complete

Remove the USB drive when the system reboots — if you don’t, it will install again instead of booting into the newly-installed HAOS.

---

Step 5: First Boot and Setup

1. After installation, HAOS boots automatically from the internal NVMe
2. A terminal-style screen shows the boot process — this is normal
3. After ~60-90 seconds, look for:

Home Assistant
Local IP: 192.168.1.XXX

Note this IP address — you’ll use it to access the web interface.

---

Step 6: Access the Web Interface

On any computer or phone on the same network:

1. Open a browser
2. Navigate to: http://homeassistant.local:8123
   OR use the IP address shown at boot: http://192.168.1.XXX:8123
3. The Home Assistant onboarding wizard appears

If the page doesn’t load:

• Wait 2-3 more minutes — HAOS takes time on first boot
• Try the IP address directly instead of homeassistant.local
• Verify the mini PC is connected to the same network Ethernet recommended

---

Step 7: Complete the Onboarding

1. Create account: Set your name, username, and password
2. Home location: Set your address for weather and sun position automations
3. Analytics: Optional — enable or skip
4. Integrations: HAOS automatically discovers devices on your network smart bulbs, Google Home, Apple TV, etc. — add what you want

---

Step 8: Recommended First Add-ons

HAOS add-ons install in one click from Settings → Add-ons → Add-on Store:

---

Step 9: Connect a Zigbee Coordinator Optional

If you have Zigbee smart devices, you need a Zigbee USB coordinator:

Recommended: SONOFF Zigbee 3.0 USB Dongle Plus-E ~$20

1. Plug the Zigbee dongle into a USB port on the mini PC
2. Go to Settings → Add-ons → Add-on Store → Zigbee2MQTT
3. Install Zigbee2MQTT, configure with the USB device path
4. Start pairing devices

For Z-Wave devices: install the Z-Wave JS UI add-on and pair your Aeotec or Zooz Z-Wave controller.

---

Troubleshooting Common Issues

HAOS Won’t Boot from USB

• Verify Secure Boot is disabled in BIOS
• Try a different USB port USB 2.0 ports sometimes work better for bootable drives
• Re-flash the USB drive with a fresh HAOS image
• Try a different USB drive — some drives have compatibility issues

“No Operating System Found” After Installation

• The USB drive was not removed before reboot — remove it and restart
• If the issue persists, the internal NVMe wasn’t written correctly — restart installation

Can’t Access homeassistant.local:8123

• Try the IP address directly shown at the HAOS console screen
• Verify the mini PC has a network connection Ethernet preferred for first setup
• Wait 3-5 minutes after boot — HAOS supervisor takes time to initialize on first run
• Check your router’s DHCP client list for a device named “homeassistant”

HAOS Doesn’t Detect My Network Interface

• Verify the mini PC’s NIC is supported Intel NICs are most reliable
• Check that your Ethernet cable is connected and the router shows the connection
• Some Realtek NICs require a kernel update — this is handled automatically by HAOS in most cases

---

Alternative: Install HAOS in Proxmox

If you want to keep using the mini PC for other services alongside HAOS:

# On Proxmox, download and import the HAOS KVM image:
wget -O haos.img.xz https://github.com/home-assistant/operating-system/releases/latest/download/haos_ova-13.0.qcow2.xz
unxz haos.img.xz

# Create VM via Proxmox GUI:
# Machine type: q35
# BIOS: OVMF (UEFI)
# Network: VirtIO
# Delete the default disk, then import the HAOS image:
qm importdisk [VM-ID] haos.img local-lvm
# Attach as scsi0 or virtio0 in VM hardware settings

This method lets HAOS run in a VM while Proxmox hosts other services on the same mini PC.

---

What to Set Up Next

With HAOS running on your mini PC:

• Best mini PC for Home Assistant — verify your hardware choice
• Home Assistant hardware requirements guide — understand add-on RAM needs
• How to run Home Assistant on Proxmox — multi-service setup guide

---

Who Should Skip This Comparison

Frequently Asked Questions

Can I install HAOS alongside Windows on the same mini PC?

Not on the same drive — HAOS replaces the existing OS. You can install HAOS to a separate USB SSD and boot it when needed, or run HAOS in a Proxmox VM alongside a Windows VM. For dedicated HAOS use, a dedicated mini PC is cleaner.

How do I update Home Assistant OS?

HAOS updates automatically when available. Check manually at Settings → System → Updates. HAOS, Home Assistant Core, and individual add-ons update independently. Always create a backup before updating: Settings → System → Backups → Create Backup.

Can I recover if HAOS breaks?

Yes. HAOS backups saved to a USB drive or network share can restore your entire configuration. If the HAOS installation itself breaks, reinstall from USB same process and restore your backup. This is why regular backups are essential.

Does HAOS use the mini PC’s RAM efficiently?

HAOS is Linux-based and very memory-efficient. A fresh HAOS installation with no add-ons uses ~1.5GB RAM. With Frigate NVR + Zigbee2MQTT + AdGuard + Node-RED running: ~4-6GB total. A 16GB mini PC has 10+ GB of headroom for growth.

How do I install HAOS on a mini PC with Proxmox?

In Proxmox: download the HAOS KVM image, create a VM with VirtIO drivers, import the HAOS disk image, and boot the VM. This allows HAOS to run alongside other Proxmox VMs and services. The official HAOS documentation covers Proxmox installation in detail.

What is the difference between Home Assistant OS and Home Assistant Container?

Home Assistant OS is the full operating system — it installs the entire HA stack including Supervisor, which enables add-ons. Home Assistant Container is just the Core in a Docker container without Supervisor or add-ons. For a dedicated mini PC, HAOS is strongly recommended — add-ons like Zigbee2MQTT, AdGuard, and Frigate install in one click.