Matter in Home Assistant: Beginner's Setup Guide

What is Matter and why does it matter for your smart home?

Matter is an open, royalty-free smart home standard developed by the Connectivity Standards Alliance (CSA) — backed by Apple, Google, Amazon, Samsung, and over 550 other companies. Released in October 2022, Matter version 1.0 established a universal application layer that lets smart home devices work with any compatible controller, regardless of brand.

Before Matter, a Philips Hue bulb worked with Alexa but needed a bridge; a LIFX bulb was Wi-Fi native but only worked with certain platforms. Every ecosystem had its own proprietary protocol. Matter changes this: a Matter-certified light switch from any manufacturer works with Home Assistant, Apple Home, Google Home, and Amazon Alexa simultaneously — and it works locally, without requiring cloud access for basic control.

Matter 1.0 supports lights, switches, plugs, thermostats, locks, blinds, and sensors. Matter 1.2 (2023) added robot vacuums, refrigerators, and smoke detectors. Matter 1.3 (2024) added energy management and water controls. The specification continues to expand rapidly.

What do you need before setting up Matter?

Matter in Home Assistant has four requirements:

• Home Assistant OS or Supervised — version 2024.1 or later. Matter is not available in HA Core/Container without complex manual setup.
• IPv6 enabled on your router — Matter uses mDNS and IPv6 for device discovery. Confirm IPv6 is not disabled in your router settings.
• The Matter Server add-on — installed and running inside Home Assistant (free, from the official add-on store).
• A Thread border router (only for Matter-over-Thread devices) — the SkyConnect dongle or an existing Apple TV 4K, HomePod, Google Nest Hub, or Amazon Echo (4th gen) all work.

If your Matter devices connect via Wi-Fi (like most smart plugs and some bulbs), you don't need any extra hardware beyond a supported HA install.

Is Home Assistant Green the best hardware for Matter beginners?

Yes — Home Assistant Green ($99) is the best beginner hardware for Matter because it comes pre-loaded with Home Assistant OS, ships in a compact plug-and-play form factor, and pairs perfectly with the SkyConnect dongle for Thread support. Unlike a Raspberry Pi (which requires OS installation, case, SD card, and power supply), the Green is ready to run in under 10 minutes.

How do you enable Matter in Home Assistant?

Enabling Matter takes about 5 minutes:

1. Go to Settings → Add-ons → Add-on Store
2. Search for "Matter Server" and install it (it's an official Nabu Casa add-on)
3. Start the add-on and enable "Start on boot" and "Watchdog"
4. Go to Settings → Devices & Services → Add Integration
5. Search for "Matter" and add it — it will auto-detect the running Matter Server
6. The Matter integration is now active and ready to commission devices

If you have Thread devices, also add the Thread integration: Settings → Devices & Services → Add Integration → Thread. If you have a SkyConnect plugged in, it will appear here automatically.

How do you add a Matter device step by step?

1. Put the device in commissioning mode — usually by holding a button for 5–10 seconds until an LED blinks. Consult your device's manual for the specific pairing sequence.
2. In Home Assistant, go to Settings → Devices & Services and click "Add Integration"
3. Select "Matter"
4. Choose "Commission new device"
5. Scan the QR code on the device's packaging (or on the device itself), or manually enter the 11-digit pairing code
6. Home Assistant will commission the device over your network. This takes 30–90 seconds.
7. The device appears in your Devices list, ready to use in automations and dashboards

You can also use the Home Assistant companion app on your phone (iOS or Android) to scan the QR code — the app handles commissioning and the device appears in HA automatically.

Does Matter work over Wi-Fi without Thread?

Yes. Many Matter devices use Wi-Fi as their transport. Smart plugs, some bulbs, and Wi-Fi thermostats with Matter certification connect directly to your home Wi-Fi router and communicate with Home Assistant over your LAN — no Thread border router needed. These devices are easier to set up and don't require the SkyConnect dongle.

Matter-over-Wi-Fi devices are great for stationary devices (plugs, thermostats) that are always near a power outlet. Matter-over-Thread is preferred for battery-powered sensors and devices in locations far from Wi-Fi coverage, since Thread's mesh networking extends range and uses far less power than Wi-Fi.

Common Matter setup problems and how to fix them

• "Commissioning failed" error: Ensure IPv6 is enabled on your router. Restart the Matter Server add-on. Make sure the device is within 5 metres of your Wi-Fi router during initial commissioning.
• Device not discovered: Check that the Matter Server add-on shows "Running." If it shows "Error," check the add-on logs for specific messages.
• Device disappears after commissioning: This usually indicates a network issue. Ensure your HA host has a stable IP address (set a DHCP reservation in your router).
• Thread devices won't commission: Confirm the Thread integration shows at least one border router. If using SkyConnect, verify it's configured for Thread (not Zigbee-only) mode in its integration settings.
• Home Assistant companion app QR scan doesn't work: Ensure the app is updated to the latest version and both your phone and HA host are on the same Wi-Fi network (same subnet, same SSID).

Frequently Asked Questions

SmartWired participates in the Amazon Associates Programme. We may earn a commission from qualifying purchases at no extra cost to you.