If you like this project and find it useful, please consider giving it a star on GitHub at https://github.com/Luligu/matterbridge-home-assistant-addon and sponsoring it.
This repository contains the Matterbridge Official Home Assistant Add-on.
It allows you to run Matterbridge as an Home Assistant Add-on.
All Matterbridge features are correctly working in the official add-on (e.g. you can update Matterbridge itself or the plugins without issues).
The Matterbridge storage and the Matterbridge plugins storage persist when you update the Add-on, rebuild or restart it.
When you build/rebuild the add-on, Matterbridge will reload all plugins that were registered (it takes time so be patient).
The Add-on can run on arm64, amd64 armv7 archs. The image is build on Debian 12 (bookworm-slim) with Nodejs 22.
The ideal companion of the add-on is the Official Matterbridge Home Assistant plugin
Click here
or from your Home Assistant web page, go to Settings, select Add-ons and click on the ADD-ON STORE button.
In the upper right corner click on the three dots menu, select Repositories and paste this link
https://github.com/Luligu/matterbridge-home-assistant-addon
then click on ADD.
You should now see your Matterbridge add-on in the add-on store and be able to INSTALL it.
Be patient cause it can takes a few minutes.
Enable Start on boot, Watchdog and Auto update.
Click on BUILD or REBUILD.
To open the Matterbridge frontend click on OPEN WEB UI.
You may be asked to install the Home Assistant Matter Server: confirm the default installation.
Since Home Assistant exposes a lot of interfaces to the containers, is better to set the matter mdns interface in the Matterbridge Settings page.
You can get the correct interface name from the Network page in the settings of Home Assistant.
In this case the correct name is end0.
