https://github.com/luligu/matterbridge-home-assistant-addon
Official Matterbridge Home Assistant Add-on
https://github.com/luligu/matterbridge-home-assistant-addon
Last synced: about 1 month ago
JSON representation
Official Matterbridge Home Assistant Add-on
- Host: GitHub
- URL: https://github.com/luligu/matterbridge-home-assistant-addon
- Owner: Luligu
- License: apache-2.0
- Created: 2024-09-09T18:52:28.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-12-05T09:42:54.000Z (5 months ago)
- Last Synced: 2025-03-20T05:11:41.264Z (about 1 month ago)
- Language: Dockerfile
- Homepage:
- Size: 51.8 KB
- Stars: 50
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 
Matterbridge
[](https://www.npmjs.com/package/matterbridge)
[](https://www.npmjs.com/package/matterbridge)
[](https://hub.docker.com/r/luligu/matterbridge)
[](https://hub.docker.com/r/luligu/matterbridge)
[](https://www.npmjs.com/package/matter-history)
[](https://www.npmjs.com/package/node-ansi-logger)
[](https://www.npmjs.com/package/node-persist-manager)
---
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.
# Matterbridge Home Assistant Add-on
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.
# Matterbridge Home Assistant plugin
The ideal companion of the add-on is the [Official Matterbridge Home Assistant plugin](https://github.com/Luligu/matterbridge-hass/blob/main/README.md)
## How to install the add-on
Click here
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FLuligu%2Fmatterbridge-home-assistant-addon)
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.
## How to configure the mdns
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.
