Skip to main content
PromptQuorumPromptQuorum
Home/Smart Home/Home Assistant: Complete Getting-Started Guide (2026)
Local-First Smart Home

Home Assistant: Complete Getting-Started Guide (2026)

Β·10 min readΒ·By Hans Kuepper Β· Founder of PromptQuorum, multi-model AI dispatch tool Β· PromptQuorum

Home Assistant is free, open-source, local-first smart home software you install on a Raspberry Pi or mini PC β€” add integrations, build a dashboard, and control devices locally with no cloud. Use Home Assistant OS (HAOS) on dedicated hardware for the easiest start.

Home Assistant is the leading local-first smart home hub: install it on a Raspberry Pi or mini PC, add integrations, and control everything locally with no cloud. This getting-started guide covers why Home Assistant, the install options, first integrations, the dashboard, your first automation, and where to add local AI later β€” without re-explaining the LLM mechanics.

Key Takeaways

  • Home Assistant is free, open-source, and local-first β€” the standard private smart home hub
  • Install Home Assistant OS (HAOS) on dedicated hardware for the easiest start
  • Raspberry Pi handles the basics; a mini PC is better if you also want local AI
  • Add integrations through the UI; no coding needed for common devices
  • Add a Zigbee or Z-Wave coordinator (USB stick) for local protocols
  • Add a local LLM brain later β€” link out for the LLM mechanics

Why Home Assistant?

Home Assistant is the foundation of a local smart home because it runs on your own hardware, speaks every major local protocol, and keeps automations working offline. It is the most flexible and private hub.

  • Local-first: control and automations run without the cloud.
  • Broad support: thousands of integrations across brands and protocols.
  • Foundation for local AI β€” see running your smart home on a local LLM.

Which Install Option Should You Choose?

Use Home Assistant OS (HAOS) on dedicated hardware for the simplest setup, a container install if you already run a server, and choose a Raspberry Pi for basics or a mini PC if you want local AI. HAOS includes the add-on system you will want.

Install methodDifficultyBest for
HAOS on dedicated deviceEasiestMost users; full add-on support
HAOS on Raspberry PiEasyBasics, low power
HAOS on mini PCEasyBasics + local AI
Container (Docker)ModerateExisting home servers/NAS

Adding Your First Integrations

Add integrations through Settings β†’ Devices & Services; many devices are auto-discovered on your network. For Zigbee or Z-Wave devices, add a coordinator first.

  • Auto-discovery finds many Wi-Fi and Matter devices automatically.
  • Add a Zigbee coordinator (and the ZHA or Zigbee2MQTT integration) for Zigbee devices β€” see smart home protocols explained.
  • Expose only the entities you want, especially before connecting voice or AI.

The Dashboard

Home Assistant auto-generates a dashboard you can customise with cards for your devices. Start with the default and refine it over time.

  • The default dashboard lists your devices and areas automatically.
  • Add cards for the controls you use most.
  • Create per-room views as your setup grows.

Your First Automation

Create a simple automation in Settings β†’ Automations using the visual editor β€” for example, turn on a light at sunset. No coding is required for common rules.

  1. 1
    Open Settings β†’ Automations & Scenes β†’ Create Automation.
  2. 2
    Choose a trigger (time, sunset, or a sensor state).
  3. 3
    Choose an action (turn on a light, send a notification).
  4. 4
    Save and test it, then refine.
  5. 5
    For context-aware rules later, see AI automations with a local LLM.

Adding AI Later

Once the basics work, add a local LLM as a conversation agent β€” but do that after your devices and automations are stable. This guide does not re-explain Ollama; link out for that.

FAQ

Raspberry Pi or mini PC for Home Assistant?

A Raspberry Pi runs Home Assistant well for typical smart home use. Choose a mini PC if you also want to run a local LLM, larger Whisper models, or Frigate camera detection on the same box, since those need more compute.

Is Home Assistant free?

Yes. Home Assistant is free and open-source. You only pay for the hardware it runs on and any optional extras (for example, a cloud relay for easy remote access). Core local control needs no subscription.

Do I need to code to use Home Assistant?

No. Common setups, dashboards, and automations are built through a graphical interface. YAML configuration is available for advanced automations but is optional for getting started.

Can Home Assistant run AI?

Yes. Home Assistant integrates with Ollama so a local model can act as a conversation agent, and it supports local voice with Whisper and Piper. Running these on a mini PC keeps everything local. See the Ollama integration guide for setup.

← Back to Smart Home