Adding Oz Matter GPO & Single Light Switch to Home Assistant (Matter)
A short troubleshooting case study and a clear step-by-step solution for local Matter integration
When new smart home products arrive, setup should be simple — especially for Matter-enabled devices. One customer recently had trouble pairing the Oz Matter GPO and Oz Matter Single Light Switch directly into Home Assistant via Matter (local, cloud-free). After testing, they discovered a reliable method to expose the devices to Matter using the SmartLife app and then add them in Home Assistant. Below are the exact steps.
The Challenge
The devices paired easily with the SmartLife (Tuya) app, but the customer could not see an obvious way to add them to Home Assistant using Matter. Their requirement was explicit: use Matter only for a local integration — no Tuya cloud dependency.
The Working Solution (Step-by-Step)
Step 1 — Prepare the device in the SmartLife app
- Open the SmartLife app.
- Select your Matter GPO (or Matter switch).
- Go to Settings.
- Tap Edit.
- Select Share Device.
- Choose Share over Matter.
- The app will generate a Matter setup code.
The Matter QR / setup code is also printed on the back of the device faceplate. You may need to remove the faceplate to see it — ask your electrician if you can’t find it.
Step 2 — Add to Home Assistant via Matter
- In Home Assistant, open Settings → Devices & Services.
- Select Matter.
- Click Add Device.
- Enter the Matter setup code you got from the SmartLife app (or the faceplate).
- Follow the pairing prompts in Home Assistant.
Once paired, the GPO and switch are fully controllable locally through Matter — no cloud dependency required.
Key Takeaways
- The Oz Matter GPO and Switch do support Matter and work locally with Home Assistant.
- The Matter setup code is accessible via SmartLife → Share over Matter, or physically on the device (behind the faceplate).
- SmartLife acts only as a way to expose the device to Matter — after that, Home Assistant controls the device locally.
- Matter pairing isn’t obvious during the initial SmartLife setup, which can cause confusion, but the devices are fully Matter-compatible once the code is retrieved correctly.