Homebridge

What it is: A lightweight Node.js server on the home network that emulates the HomeKit Accessory Protocol (HAP). Through plugins it brings devices that don't support HomeKit into Apple Home and Siri: vendor clouds, cameras, TVs, thermostats.1 It's a community, non-commercial open-source project not affiliated with Apple. From version 2, plugins can also expose devices over Matter, i.e. to Google Home or Alexa too. The current version is 2.4.0 (08/2026).1

Ways into Apple Home
Three ways into Apple Home: native HomeKit/Matter, Homebridge and Node-RED with NRCHKB. Own diagram (Synthesis) based on Homebridge docs1, Apple Support2 and3.

When Homebridge and when something else

Synthesis based on Homebridge docs1, Apple Support2 and3:

Situation Path
The device supports HomeKit or Matter add it directly to Apple Home
No HomeKit, a plugin exists, Apple Home automations are enough Homebridge
The device needs logic, data or a combination of sources Node-RED + NRCHKB

Installation

Adding to Apple Home

  1. In the Home app: Add Accessory and scan the QR code from the Homebridge UI or log.1
  2. Without plugins, Home says "Additional Set-up Required". That's fine; further devices then appear without re-pairing.1
  3. Cameras and most TVs are paired separately as their own accessories.1
  4. Automations and control away from home need a home hub (Apple TV or HomePod).2

Child bridges

A plugin runs as its own bridge in a separate process (from 1.3.0). Set up in the UI via Child Bridge Config.1

mDNS and discovery

Homebridge announces itself on the network via mDNS. The advertiser can be switched:1

Matter (Homebridge 2)

Per Homebridge docs1:

Troubleshooting

Per Homebridge docs1:

Related

Sources

  1. Homebridge: README and wiki (child bridges, mDNS advertiser, Matter) โ†— โ€” README and wiki (child bridges, mDNS, Matter, limits).
  2. Apple Support: home hub, Matter in the Home app, Apple Home update โ†— โ€” home hub.
  3. node-red-contrib-homekit-bridged (NRCHKB): README, npm, issues โ†— โ€” the Node-RED alternative.
  4. umbrelOS / Umbrel Home (README, app store, product page) โ†— โ€” the Homebridge app on Umbrel (image, port, host network, root).