Aqara Hub and Matter Setup and Troubleshooting
Aqara hubs do two jobs at once. They run Aqara’s own Zigbee sensors and switches through the Aqara Home app, and newer models such as the Hub M3 and Hub M100 also act as a Matter controller, a Matter bridge and a Thread border router. That flexibility is also why setup can go sideways: a hub can be fine in Aqara Home but missing in Apple Home, or a Thread sensor can pair to the wrong controller. This guide follows Aqara’s user manual, product pages and developer documentation for setup, status lights, Matter sharing and resets.
Affiliate disclosure: As an Amazon Associate, Everyday Tech Guide earns from qualifying purchases. This page contains labeled affiliate links; we may earn a commission if you purchase through them, at no additional cost to you. Our picks are not paid placements.
Quick answers
- Hub won’t bind in Aqara Home? Aqara lists three usual causes: special characters in the Wi-Fi name or password, router “anti-leeching” settings, and AP isolation (Aqara: Hub M3 user manual).
- What does the light mean? Solid blue is normal; flashing yellow means it is waiting to connect (Aqara: Hub M3 user manual). The full table is below.
- Adding it to Apple Home, Google Home or Alexa? Use the Matter QR code or setup code from the manual in the other app (Aqara: Hub M3 user manual, Aqara developer docs: Google Home).
- Starting over? On the Hub M3, hold the button for 10 seconds to reset the network, or press it 10 times to restore factory settings (Aqara: Hub M3 user manual).
- Zigbee device from another brand won’t pair? Aqara says the M3 and M100 work only with Aqara-brand Zigbee devices (Aqara’s Amazon listings).
What Aqara’s Matter hubs do
Aqara describes the Hub M3 and Hub M100 with the same set of roles (Aqara developer docs: Hub M3, Aqara developer docs: Hub M100):
| Role | What it means |
|---|---|
| Matter controller | Adds Matter devices from other brands into the Aqara Home app. |
| Matter bridge | Shares Aqara Zigbee devices with Matter platforms such as Apple Home, Amazon Alexa, Google Home, SmartThings, Home Assistant and Homey. |
| HomeKit bridge | Shares Aqara Zigbee devices with Apple HomeKit. |
| Thread border router | Connects Matter-over-Thread devices to your home network (Aqara: Hub M3 user manual). |
The two models differ mainly in size and connections. The M3 has dual-band Wi-Fi (2.4 and 5 GHz), an RJ45 Ethernet port with PoE and USB-C power (Aqara: Hub M3 user manual). The M100 is a small USB-A stick that uses 2.4 GHz Wi-Fi 6 and, per Aqara’s listing, supports up to 20 Aqara Zigbee and 20 Thread devices. For the M3, Aqara’s product page gives up to 127 Thread and Zigbee devices (Aqara: Hub M3 product page). If you are still choosing a hub, our Thread border router and Matter hub guide compares options from several brands.
How to set up the Hub M3
Aqara’s steps from the Hub M3 manual (Aqara: Hub M3 user manual):
- Choose a spot: a table, a wall or the ceiling. On a table, keep the infrared emitting area on the front clear.
- Power it with a USB-C adapter (Aqara asks for at least 5 V 2 A; the adapter isn’t included) or with PoE through the RJ45 port.
- Pick wired or Wi-Fi. Aqara recommends a wired connection where possible because it avoids wireless instability.
- Install the Aqara Home app, tap “Home”, then “+” in the top right, choose “Hub M3” and follow the in-app steps.
- When asked for the second confirmation, scan the QR code on the hub or manual, or enter the 8-digit pairing code.
- When the status light turns solid blue, the hub is set up.
During Wi-Fi setup, keep your phone close to the hub and on the same network the hub will join. The hub supports Aqara MagicPair, so the app can find it automatically once it is powered and waiting to connect (Aqara: Hub M3 user manual).
For the M100, Aqara’s listing says to use a 5 V 0.5 A USB adapter (not included), keep it powered at all times, and keep the hub on the same local network as your router. Aqara’s listings for both hubs suggest placing them 6 to 19 feet from the router.
Hub M3 status light meanings
From the Hub M3 manual (Aqara: Hub M3 user manual):
| Light | Meaning |
|---|---|
| Solid yellow | Starting up |
| Flashing yellow | Waiting to connect |
| Flashing blue | Connecting |
| Slow flashing blue | Connected; the account is binding |
| Solid blue | Normal |
| Solid white | Started more than 10 minutes ago with no network set up |
| Flashing purple | Ready to add child devices |
| Slow flashing yellow | Firmware updating |
| Off | Light turned off, or the hub has no power |
A solid white light usually means setup never finished. Re-open Aqara Home and add the hub again, or reset the network (below) and start over.
Fixing “binding failed” in Aqara Home
Aqara lists three common reasons a hub fails to bind (Aqara: Hub M3 user manual):
| Cause | Fix |
|---|---|
| Your Wi-Fi name or password uses special characters the hub doesn’t support | Change it to common characters and try again. |
| The router has Wi-Fi “anti-leeching” (device-blocking) turned on | Turn it off, or allow the hub, then retry. |
| The router has AP isolation on | Your phone can’t see the hub on the local network. Turn AP isolation off for the network you’re using. |
Our advice beyond Aqara’s list: if your router uses one name for both 2.4 and 5 GHz and the M100 won’t join, check the router has 2.4 GHz turned on, since the M100 uses 2.4 GHz only. Avoid guest networks during setup, because many routers isolate guest devices by default. Our IoT network guide explains the trade-offs.
Adding the hub to Apple Home, Google Home or Alexa
Apple Home (HomeKit): in the Home app, tap “+”, then Add Accessory, and scan or type the HomeKit setup code from the hub or manual (Aqara: Hub M3 user manual). Keep that code somewhere safe. If adding fails, Aqara says to hold the hub’s button for 10 seconds to reset the network, then add it again. Aqara’s fixes for specific errors: for “Unable to add accessory”, restart your iPhone or iPad, reset the hub and retry; for “Accessory not found”, reset the hub, wait 3 minutes and enter the code manually.
Any Matter app: scan the Matter QR code on the manual, or enter the 11-digit setup code, in the other platform’s app (Aqara: Hub M3 user manual).
Google Home or Alexa without Matter: in Aqara Home, go to Profile, Connect to Ecosystems, then Google Home or Amazon Alexa, and link your account (Aqara developer docs: Google Home, Aqara developer docs: Amazon Alexa).
Pairing Thread and Zigbee devices
Aqara’s manual separates the two (Aqara: Hub M3 user manual):
- Aqara Zigbee and Bluetooth devices: follow the device’s manual and choose the specific M3 hub when adding it.
- Matter-over-Thread devices: the M3 acts as the Thread border router, so you follow the device’s own manual and don’t pick the hub during pairing.
To add a Matter device straight to Google Home or Alexa instead, Aqara says you need that platform’s own Thread-capable Matter controller, such as a Nest Hub (2nd gen) or an Echo (4th gen) (Aqara developer docs: Google Home, Aqara developer docs: Amazon Alexa). See Matter vs Thread explained for how controllers and border routers fit together.
How to reset an Aqara Hub M3
The Hub M3’s button has two reset options (Aqara: Hub M3 user manual):
- Press and hold for 10 seconds: resets the network and unbinds the hub from your account. Use this to change Wi-Fi or re-add the hub.
- Press 10 times: restores factory settings.
A factory reset is the bigger step, so try the network reset first. Check the Aqara Home app for your model’s steps before resetting a hub that runs many devices.
Aqara hubs mentioned in this guide
Details come from Aqara’s documentation and the Amazon listings. When we checked on October 23, 2026, both were in stock as new items sold by AqaraDirect, Aqara’s own store on Amazon, and shipped by Amazon.
Aqara Hub M3 (HM-G01E)
Aqara’s larger hub: Matter controller and bridge, Thread border router, Aqara Zigbee hub and infrared blaster, with dual-band Wi-Fi, PoE Ethernet and USB-C power (Aqara: Hub M3 user manual, Aqara: Hub M3 product page). The setup steps and light table above come from its manual. A USB adapter isn’t included, per the listing.
View the Aqara Hub M3 on Amazon (affiliate link) →
We have not independently tested this product. Availability, specifications and platform support can change; confirm the details on the product listing and the manufacturer's site.
Aqara Hub M100 (HM-G02E)
A USB-A stick hub with the same Matter controller, Matter bridge and Thread border router roles, on 2.4 GHz Wi-Fi 6 (Aqara developer docs: Hub M100). The listing gives up to 20 Aqara Zigbee and 20 Thread devices, and the 5 V 0.5 A adapter is sold separately.
View the Aqara Hub M100 on Amazon (affiliate link) →
We have not independently tested this product. Availability, specifications and platform support can change; confirm the details on the product listing and the manufacturer's site.
Frequently asked questions
Why won’t my Aqara hub connect to Wi-Fi?
Aqara lists special characters in the Wi-Fi name or password, router anti-leeching settings, and AP isolation as the usual causes. The M100 also needs 2.4 GHz Wi-Fi.
What does a solid white light on the Aqara Hub M3 mean?
The hub has been on for more than 10 minutes without a network set up. Add it again in Aqara Home, or hold the button for 10 seconds to reset the network first.
How do I reset an Aqara Hub M3?
Hold the button for 10 seconds to reset the network and unbind it, or press it 10 times to restore factory settings.
Can I use the Aqara hub with Google Home or Alexa?
Yes. Add it to the other app with the Matter QR code or setup code, or link accounts in Aqara Home under Profile, Connect to Ecosystems.
Do I need to select the hub when pairing a Thread device?
No. Aqara says Matter-over-Thread devices don’t need the M3 chosen during pairing. Aqara Zigbee devices do: choose the specific hub when adding them.
Will the Aqara hub work with other brands’ Zigbee devices?
No. Aqara’s listings say the Hub M3 and M100 support Aqara-brand Zigbee devices only. Matter devices from other brands can be added through Matter.
Should I use Ethernet or Wi-Fi for the Hub M3?
Aqara recommends a wired connection where possible because it avoids wireless instability. The M3 supports both Ethernet (with PoE) and dual-band Wi-Fi.
Where do I find the HomeKit or Matter code?
On the hub and in the printed manual. Aqara asks you to keep the code safe, so store the manual somewhere you can find it.