In this article, I’m sharing a way to expose devices you have paired in Home Assistant as a Matter device.

I'm using it to control HomeAssistant devices via Homepod mini.

 

Table of Contents

Project Information

Project on github:https://github.com/t0bst4r/home-assistant-matter-hub

Latest version：https://github.com/t0bst4r/home-assistant-matter-hub/releases

Supported entities:https://github.com/t0bst4r/matterbridge-home-assistant?tab=readme-ov-file#supported-entities

Installation Guide

1.Addon：https://t0bst4r.github.io/home-assistant-matter-hub/installation#id-1-native-home-assistant-addon

2.Docker image:https://t0bst4r.github.io/home-assistant-matter-hub/installation#id-2-1-docker-image

 

History

https://github.com/t0bst4r/matterbridge-home-assistant-addon

2024-11-27，This addon should not be used anymore! It will be replaced with home-assistant-matter-hub.

https://github.com/t0bst4r/home-assistant-matter-hub

 

How it work

To use a Matterbridge with Home Assistant, install the Matterbridge Add-on, start it to generate a pairing QR code, and then use a Matter-compatible app like Google Home to scan the code and link it. This process connects your Home Assistant devices to other Matter ecosystems

Matterbridge to connect to home assistant with url

In alpha.87 from scratch I created a new bridge

 added device "pattern: switch.air_con" in new bridge

 

The project is build on top of https://github.com/project-chip/matter.js.

 

There are several advantages actually:

1. Works completely locally over Matter

2. Much easier setup process (one pairing code for all devices)

3. Do not need to do it indivudlaly for Google Home, Alexa, Apple Home.

4. Great for exposing unsupported devices e.g. DIY Devices

 

 

For HassOS User

 

Step 1.Installing the Matter Bridge HA Add-on

To install the Matter Bridge Add-on, you need to add the custom repository in Home Assistant first. Navigate to Settings > Add-ons > Add-on store > Three dots in corner > Repositories and add the following repo:

https://github.com/t0bst4r/matterbridge-home-assistant-addon （Note:DEPRECATION）

https://github.com/t0bst4r/home-assistant-matter-hub

2024-11-27，This addon should not be used anymore! It will be replaced with home-assistant-matter-hub.

https://github.com/t0bst4r/home-assistant-matter-hub

 

For Ha Docker User

Before you start, you will need:

Internet access

Docker on an always-powered device

Home Assistant (Optional)

 

step 1. Install Matterbridge docker

docker-compose.yml

services:
  matter-hub:
    image: ghcr.io/t0bst4r/home-assistant-matter-hub:3.0.0-alpha.95
    restart: unless-stopped
    network_mode: host
    environment: # more options can be found in the configuration section
      - HAMH_HOME_ASSISTANT_URL=http://192.168.2.125:8123/
      - HAMH_HOME_ASSISTANT_ACCESS_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJhZjZkYTc5YTk5ODU0YWYwYjMyMzZhYTZmZTI2ZDA0MyIsIhdCI6MTc2MjAwMzQyNiwiZXhwIjoyMDc3MzYzNDI2fQ.kMJne4WMlEgozsWux6sNlYEb5cYf4I4juc0DaTRvVlI
      - HAMH_LOG_LEVEL=info
      - HAMH_HTTP_PORT=8482
    volumes:
      - /datadocker/home-assistant-matter-hub:/data

 

step 2.Open WebUI

click Open WebUI from the add-on's page to access the Matterbridge interface

http://192.168.2.125:8482/bridges/create

output

@raspberrypi:/datadocker/home-assistant-matter-hub# docker compose up
[+] Running 1/1
 ✔ Container home-assistant-matter-hub-matter-hub-1  Created                                                          
Attaching to matter-hub-1
matter-hub-1  | 2025-11-01 13:40:30.148 INFO   HomeAssistantClient  Waiting for Home Assistant to be up and running - 
matter-hub-1  | 2025-11-01 13:40:35.153 INFO   HomeAssistantClient  Home assistant reported to be up and running
matter-hub-1  | 2025-11-01 13:40:35.164 INFO   WebApi               HTTP server (API & Web App) listening on port 848

step 3. create matter hub bridge

http://192.168.2.125:8482/bridges/create

 

useful links

https://smarthomescene.com/guides/exposing-home-assistant-entities-as-matter-devices/

https://github.com/Luligu/matterbridge

https://github.com/t0bst4r/home-assistant-matter-hub/issues/846

Comments


Comments are closed