docs: add Matter bridge migration plan (matter-hub EOL) #26
Conversation
- Add migration guide: homeassistant/matter-migration.md - Document migration from t0bst4r/home-assistant-matter-hub to Luligu/matterbridge - Add EOL warning to README.md for Matter Hub service - Upstream project end-of-maintenance since January 2026
There was a problem hiding this comment.
Pull request overview
This pull request adds comprehensive migration documentation for transitioning from the end-of-maintenance t0bst4r/home-assistant-matter-hub project to Luligu/matterbridge. The documentation is provided in German and includes detailed step-by-step instructions for the migration process.
Changes:
- New migration guide with comprehensive instructions for migrating from matter-hub to matterbridge
- Added EOL warning to README.md with link to migration documentation
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.
| File | Description |
|---|---|
| homeassistant/matter-migration.md | Complete migration guide with 6 phases covering preparation, installation, configuration, and rollback procedures |
| README.md | Added EOL warning badge and link to migration guide for Matter Hub service |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| 1. **Plugins** → `matterbridge-hass` → **Config** | ||
| 2. Einstellungen: | ||
|
|
||
| | Feld | Wert | | ||
| |------|------| | ||
| | **host** | `ws://<YOUR-HA-IP>:8123` | | ||
| | **token** | `<dein-long-lived-token>` | |
There was a problem hiding this comment.
Storing the long-lived access token in the web-based configuration could pose a security risk. The documentation should include a warning about securing access to the Matterbridge web frontend (port 8283), especially if the server is exposed to a network beyond localhost. Consider adding recommendations for firewall rules or reverse proxy authentication.
|
|
||
| # NEU: Matterbridge | ||
| matterbridge: | ||
| image: luligu/matterbridge:latest |
There was a problem hiding this comment.
The Docker Compose example configures matterbridge using the mutable luligu/matterbridge:latest tag, which creates a supply chain risk because any future image pushed to that tag will be pulled and executed with host networking and access to your home automation environment. An attacker who compromises the image registry or the maintainer’s account could ship a malicious update that gains control over Home Assistant or the host. Pin the image to a specific immutable version or digest and update it explicitly after verification, rather than relying on latest.
Summary
homeassistant/matter-migration.mdt0bst4r/home-assistant-matter-hubtoLuligu/matterbridgeReason
Upstream project (
t0bst4r/home-assistant-matter-hub) is end-of-maintenance since January 2026.Changes