MMatterhome

Compatibility update / August 18, 2026

Homebridge 2.4 fixes Matter brightness and state failures

Homebridge 2.4 fixes failed Matter brightness commands, repeat UI requests, and state updates after plugin changes, but its Matter bridge remains opt-in and uncertified.

HomebridgeMatterSmart home platforms
By Matterhome Editorial Team/Editorial lead JC Martinez/
GitHub release preview for Homebridge version 2.4.0
Official GitHub release preview for Homebridge 2.4.0. Matterhome has not tested the update.

Homebridge 2.4.0, released on August 16, 2026, fixes several failures in its optional Matter bridge. The update addresses brightness commands that could fail on dimmable lights, successful commands that the Homebridge interface could send again, and accessory state updates that could stop working after a plugin refreshed an endpoint.

The dimming repair follows a report from a Homey and Plejd setup where Matter brightness commands became unreliable after updating from Homebridge 2.2.1 to 2.3.1. That report used an experimental Plejd plugin, so it did not prove that every dimmable-light plugin was affected. The 2.4.0 release notes nevertheless describe the fix at Homebridge's shared Matter layer rather than as a Plejd-only change.

The release also keeps a restored color light's advertised features after a restart and passes each Matter cluster's feature map to the interface. In normal terms, the interface and plugins can offer controls that match what an accessory actually declares instead of assuming a broader feature set. This should reduce misleading controls and stop a restored color light from losing features across restarts, but it does not add new capabilities to the physical device.

Only Homebridge 2 installations with Matter enabled on a bridge, and plugins that publish through Homebridge's Matter API, use this path. A HomeKit-only bridge is not changed by these Matter fixes. Homebridge can expose supported plugin accessories to Apple Home, Google Home, Alexa, SmartThings, Homey, and other Matter controllers, but the project is explicit that its implementation is not certified by the Connectivity Standards Alliance. A receiving controller may display an uncertified-accessory warning.

Update Homebridge before changing a failing light plugin or rebuilding its Matter fabric. Version 2.4.0 is the current package and requires Node.js 22, 24, or 26. Back up the Homebridge configuration, install the update, restart the affected bridge, then test on/off, brightness, and a state change made outside the receiving Matter app. Re-pairing should be a last step, not the first response to the 2.3.x failures, because 2.4.0 is designed to repair the bridge behavior without changing the physical accessory's firmware or native connection.

Content feedback

Spot a mistake or missing context?

Send a quick note so it can be checked against the source material.

Report content issue