Getting started: Home Assistant in Docker on a NAS
Running Home Assistant in Docker on a NAS you already own is the cheapest reliable way to start: no extra computer to buy, no SD card to wear out, and your automations live next to your files and backups.
Step 1 — The Home Assistant container
Create a dedicated folder for Home Assistant's configuration, then run the official home-assistant image with host networking (required for device discovery), your timezone set, and that folder mounted to /config. Restart policy: unless-stopped, so it comes back on its own after a power cut or NAS reboot. Open the web interface on port 8123, create your owner account, and turn on automatic backups before you add a single device — a backup you have never tested is a hope, not a backup.
Step 2 — Matter, the right container
Matter devices need the Matter Server running alongside Home Assistant. Use the official home-assistant-libs/python-matter-server image — not the similarly named JavaScript images, which are a common wrong turn. It also needs host networking, plus IPv6 and Thread enabled on your router. On a mesh system like eero, the routers already act as Thread border routers, so Matter-over-Thread devices pair from your phone with no extra hardware.
Step 3 — Your first integrations
Add integrations in this order: your router (presence detection), your phone (the companion app — your most useful sensor), weather, and any smart devices you already own. Resist the urge to buy hardware in week one; a week of living with presence and notifications teaches you which automations you actually want.
Two mistakes that catch almost everyone
- Zigbee radio type: when you add a modern Zigbee coordinator in ZHA, choose radio type Ember. Older guides say EZSP for the same chip and the wrong choice simply fails silently.
- Flashing Bluetooth proxies: in the ESPHome web installer, small boards like the M5Stack ATOM Lite are listed under Generic ESP32, not under their brand name.
Next steps
With the hub running, the next chapter explains the radios — which coordinators to buy, which your router already provides, and which you can safely skip: Radios & protocols. Or jump to the priced build list.