# Matter-Hub

Matter-Hub is a Home Assistant integration that exposes existing Home Assistant devices to Matter controllers such as Apple Home, Google Home, Alexa, and Aqara Home. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/7298/matter-hub

## Description

Matter-Hub is a Home Assistant integration that exposes existing Home Assistant devices to Matter controllers such as Apple Home, Google Home, Alexa, and Aqara Home.

## Platform availability

Available on 1 of 9 platforms: Proxmox.

## Health score

71/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 4 days ago)
- Popular: 62 (1,309 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=matter-hub
- GitHub: https://github.com/RiDDiX/home-assistant-matter-hub
- Documentation: https://riddix.github.io/home-assistant-matter-hub

## Common questions

### Will paired devices survive migration from t0bst4r's original Matter-Hub?

Yes, the community fork's migration guide says paired devices will continue to work after moving to the new fork.

### Which Matter-Hub add-on slug should a typical Home Assistant user install?

Use the hamh stable add-on, with hamh-alpha and hamh-testing also available. The README recommends stable for most users and warns testing is highly unstable.

### What should I expect after upgrading Matter-Hub from 2.0.46?

Some entities re-pair once and lose room assignment in the controller, including leak and freeze binary sensors and entities using the On/Off Switch override. A light may lose its automatic power or energy readout, so you may need to re-map the sensor and reassign rooms.

### Does Matter-Hub need port forwarding for Apple Home, Google Home, or Alexa to reach Home Assistant?

No, Matter-Hub exposes devices over Matter using local communication, so the README says port forwarding is not required.

### What Alexa and Google Home limits can prevent Matter-Hub devices from pairing?

Alexa may fail with too many devices on the bridge, around 80 to 100, and needs an Amazon Matter device. Google Home needs an actual Google Hub, not just the app, and may deny an uncertified Matter device.

---
Source: Our Local Host (https://ourlocalhost.com/app/7298/matter-hub), the self-hosted and open-source app directory.