Complete Stable 2.0.55 guide
Start with installation and your first bridge, then work through filtering, device mapping, Apple Home, Google Home, Amazon Alexa, multi-fabric, health diagnostics, networking, security, plugins and recovery. The 22 chapters are arranged in four parts; find the Adoption Guide, Prompt Library and Skill Handbook in the Resource Hub.
Foundations: installation and interface
What Matter Hub is
Understand bridges, fabrics, controllers and endpoints, and distinguish Matter Hub from the Home Assistant Matter integration.
02Installing Stable 2.0.55
Compare add-on, Docker and npm installations, then prepare persistence, networking and the first startup.
03The dashboard and the interface
Learn the main pages, status summary, widgets, language, themes and System Logs entry points.
04Creating your first Matter bridge
Use the Wizard, templates, Area Setup and network preflight to plan your first bridge safely.
Core: filtering and mapping
The complete Filter Engine
Master Include, Exclude, ANY, ALL, regex, areas, labels and every matcher.
06Advanced bridge settings and feature flags
Understand every Stable 2.0.55 feature flag, identity, synchronization and controller workaround.
07Devices and Entity Mapping
Search, filter and adjust entity mappings; manage names, identification data, profiles and device images.
08Composed devices and linked entities
Combine battery, energy, temperature, humidity and other linked entities into devices controllers understand.
09Device mapping 1: control devices
Reference the complete Matter mapping for lights, switches, locks, covers, climate, fans and humidifiers.
10Device mapping 2: sensors and energy
Review sensors, binary sensors, weather, air quality, power, batteries and EVSE.
11Device mapping 3: special devices
Cover media players, valves, water heaters, alarms, events, buttons, robot vacuums and lawn mowers.
12Standalone Devices and Server Mode
Understand experimental Server Mode, primary entities, linked entities, commissioning and limitations.
Commissioning: controllers and fabrics
Commissioning and multi-fabric
Use QR and manual codes safely; understand fabrics, sessions, resets and adding multiple controllers.
14Commissioning to Apple Home
Commission with Apple Home, organize rooms and perform safe checks for No Response.
15Commissioning to Google Home
Use the Google Home app to complete commissioning, synchronization and room organization.
16Commissioning to Amazon Alexa
Handle port 5540 for first commissioning, scale constraints and Alexa-specific feature flags.
17Aqara, SmartThings and controller compatibility
Compare Apple, Google, Alexa, Aqara and SmartThings, then plan multi-fabric and split bridges.
Operations: monitoring, security and recovery
Bridges, devices and startup management
Start, stop, run batch actions, manage priorities, Force Sync, import and export, and inspect the device tree.
19Health, Network Map and diagnostics
Inspect HA, bridges, fabrics, sessions, mDNS, System Logs, metrics and network topology.
20Network and secure deployment
Plan IPv6, mDNS, VLANs, firewalls, reverse proxies, authentication and Lock Credentials.
21The plugin system, API and WebSocket
Understand experimental built-in plugins, third-party packages, REST, WebSocket, health and metrics.
22Backup, restore, migration and full troubleshooting
Build backup and restore strategies, then troubleshoot No Response, commissioning failures and migration by symptom.