Skip to content

matter-bridge

matter-bridge is a Matter controller and a Matter to MQTT bridge, written in Rust on rs-matter. It commissions Matter devices onto a fabric of its own, subscribes to them, and publishes every attribute change and event to MQTT, with Home Assistant discovery; reads, writes and commands go the other way. It is a single static binary with no runtime, small enough for routers and gateways, and its controller is a library crate for anyone building Matter software in Rust.

This site is the user guide and the reference. The README is the two-minute overview; the API docs cover every type and function.

You want to Read
try it with a reference device Getting started
run it Installation
add devices Commissioning
connect it to Home Assistant Home Assistant
script it or build on its topics MQTT API
change a setting Configuration and the reference
embed the controller in Rust Library overview
understand how it works Architecture, Design
fix a problem Troubleshooting and FAQ

matter-bridge is at 0.x. CI commissions and controls connectedhomeip’s reference device on every commit, but it has not been tested with commercial devices yet, and it does not verify device attestation yet: only commission devices you trust.

Matter is a trademark of the Connectivity Standards Alliance. This project is not affiliated with or certified by the CSA.

  • Node: a Matter device, identified on a fabric by a 64-bit node id. It has endpoints, each serving clusters (On/Off, Level Control, Temperature Measurement) made of attributes, commands and events.
  • Fabric: a set of nodes that trust one root certificate authority. The bridge creates its own fabric, with its own CA, and adds devices to it. A device can belong to several fabrics at once (multi-admin): Apple Home, Google Home and the bridge can all control it.
  • Commissioning: adding a device to a fabric, using its pairing code (the QR code MT:... or the 11-digit manual code).
  • Device attestation: the check that a device is a certified product, by its attestation certificate and the CSA’s certification declaration.
  • Thread: a low-power IPv6 mesh network some Matter devices use, reached through a border router.