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

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.