How to Set Up Matter Devices in Home Assistant (2025)

Matter promised to simplify the smart home, and in fairness it has made progress. In 2025, adding supported devices to Home Assistant is far less painful than it was during the first wave of Matter launches. But it still helps to understand what is happening under the hood, especially if Thread is involved.

This guide covers the essentials: how Home Assistant acts as a Matter controller, when you need a Thread border router, how pairing works, and what to do when it inevitably goes slightly wrong.

What You Need Before You Start

• A current Home Assistant installation
• The Matter Server add-on installed
• The Matter integration added in Home Assistant
• For Thread devices: a compatible Thread border router
• Your Matter device's pairing code or QR code

It helps if your phone, Home Assistant box, and target device are on a healthy local network before you begin. Many pairing failures are really network discovery failures in disguise.

Step 1: Set Up Home Assistant as a Matter Controller

Open the Home Assistant add-on store and install the Matter Server add-on. Start it, then go to Settings → Devices & Services and add the Matter integration if it is not already present. Home Assistant will then be ready to commission Matter devices into your home.

Think of the Matter Server as the component that handles the protocol plumbing, while Home Assistant provides the user-facing integration and entity model. Once the server is healthy, Home Assistant can discover and manage compatible Matter accessories.

Step 2: Pair a Matter Device

1. Put the device in pairing mode according to its manual
2. In Home Assistant, open the Matter integration and choose Add device
3. Scan the QR code or enter the numeric setup code manually
4. Wait for commissioning to complete and assign the device to an area

If the device is a Wi-Fi Matter accessory, pairing is usually straightforward. If it is a Thread accessory, Home Assistant also needs access to a functioning Thread border router.

Thread Border Routers Explained

Thread devices do not connect directly to your Wi-Fi router. They form a low-power mesh and rely on a Thread border router to bridge that mesh to the rest of your network. Common border routers include newer Apple TV and HomePod models, some Google Nest devices, and Home Assistant-compatible radios or appliances acting in that role.

In Home Assistant, Thread support is much smoother when your border router is visible and healthy. The key point is that Matter and Thread are not the same thing. Matter is the application standard; Thread is one possible transport underneath it. You can have Matter over Wi-Fi or Matter over Thread.

If you are using Home Assistant Yellow or another box with appropriate radio support, setup tends to be cleaner because the ecosystem is more tightly controlled.

Common Pairing Problems and Fixes

Device not found during commissioning

Make sure the device is actually reset and in pairing mode. Many accessories only stay in this mode for a couple of minutes. If needed, factory reset and try again.

Thread device refuses to join

Check that you really do have a Thread border router on the network and that it is exposed correctly to Home Assistant. Distance also matters more than many people expect during initial joining.

Accessory paired elsewhere first

Some Matter devices behave badly if they were originally commissioned to another ecosystem. Remove them cleanly or factory reset before pairing into Home Assistant.

Network weirdness

Multicast and mDNS issues can break discovery. Flat local networks generally work better than heavily segmented VLAN setups unless they are configured very carefully.

Best Practices

• Update device firmware before judging Matter stability
• Keep pairing physically close for the first setup
• Add one device at a time if you are diagnosing issues
• Use clear area assignments and entity names immediately

If you want a dedicated Home Assistant machine with strong expansion potential for Matter and Thread work, Home Assistant Yellow is still one of the most interesting options.

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