Initial commit: homelab infrastructure wiki

- Full Obsidian vault content
- Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte)
- Media stack documentation
- Traefik HA setup
- Automation scripts
- Bachelor party planning

homelab/entities/aqara-hub-m3.md

@@ -0,0 +1,84 @@
+---
+title: Aqara Hub M3
+created: 2026-05-10
+updated: 2026-05-10
+type: entity
+tags: [hub, matter, zigbee, smart-home, iot, ecosystem]
+confidence: high
+---
+
+# Aqara Hub M3
+
+> Aqara's Matter-compatible smart home hub. Provides a secondary Zigbee coordinator and Matter bridge for Aqara devices, independent of [[home-assistant-connect-zbt-2]].
+
+## Overview
+
+| Field | Value |
+|-------|-------|
+| **Manufacturer** | Aqara |
+| **Model** | Aqara Hub M3 |
+| **Location** | Bedroom |
+| **VLAN** | IoT VLAN 30 |
+| **Protocols** | Zigbee 3.0, Thread, Matter, Wi-Fi |
+| **Matter Support** | Yes — can be commissioned into multiple fabrics |
+
+## Role in the Smart Home
+
+The Hub M3 serves as Aqara's ecosystem bridge:
+
+1. **Aqara Cloud Bridge** — connects Aqara devices to the Aqara cloud app
+2. **Matter Bridge** — exposes paired Aqara Zigbee devices to Matter controllers
+3. **Secondary Zigbee Coordinator** — manages its own Zigbee mesh separate from [[home-assistant-connect-zbt-2]]
+4. **Thread Border Router** — can participate in the Thread mesh
+
+## Connected Aqara Devices
+
+The Hub M3 bridges these devices via Matter:
+
+| Device | Location | Model | Protocol |
+|--------|----------|-------|----------|
+| Aqara Door/Window Sensor | Rooftop | Aqara Door/Window Sensor | Zigbee |
+| Aqara Vibration Sensor T1 | Rooftop | Aqara Vibration Sensor T1 | Zigbee |
+| Aqara Motion Sensor P1 | Living Room | Aqara Motion Sensor P1 | Zigbee |
+| Aqara Light Switch H2 US | Baby Room | Aqara Light Switch H2 US | Zigbee |
+| Aqara Light Switch H2 US | Front Door | Aqara Light Switch H2 US | Zigbee |
+| Aqara Light Switch H2 US | Entrance | Aqara Light Switch H2 US | Zigbee |
+| Aqara Light Switch H2 US | 1st Floor | Aqara Light Switch H2 US | Zigbee |
+| Aqara Colorful Ceiling Light | Baby Room | Colorful Ceiling Light 36W | Zigbee |
+| Aqara Smart Lock U100 | Front Door | Aqara Smart Lock U100 | Zigbee/BLE |
+| Aqara Camera Hub G3 | — | Camera Hub G3 | Wi-Fi |
+| Aqara Video Doorbell G410 | Front Door | Smart Video Doorbell G410 | Wi-Fi/Zigbee |
+
+## Multi-Fabric Architecture
+
+The Hub M3 is a key node in the [[matter-multi-fabric]] setup:
+
+- **Fabric 1 (HA)**: Commissioned into [[panda]]'s Matter fabric via [[home-assistant-connect-zbt-2]]
+- **Fabric 2 (Apple Home)**: Can be commissioned into Apple Home via Apple TV 4K
+- **Fabric 3 (Google Home)**: Can be commissioned into Google Home via Nest Hub
+- **Fabric 4 (Alexa)**: Can be commissioned into Alexa via Echo Dot
+
+Matter multi-admin allows up to 5 fabrics simultaneously.
+
+## Dual Path: ZHA vs Aqara Hub
+
+Some Aqara devices (sensors, switches, lock) are visible through **two paths**:
+
+1. **ZHA path**: Device → Zigbee → Connect ZBT-2 → [[panda]] HA (direct, low-latency)
+2. **Matter Bridge path**: Device → Zigbee → Hub M3 → Matter → HA (bridged, adds latency)
+
+The ZHA path is preferred for automation reliability. The Matter Bridge path is useful for exposing devices to other ecosystems (Apple, Google, Alexa).
+
+## Relationships
+
+- Bridges Aqara devices into [[matter-multi-fabric]]
+- Connected to [[panda]] via Matter integration
+- Works alongside [[home-assistant-connect-zbt-2]] (dual Zigbee mesh)
+- Complemented by Aqara Camera Hub G3 (separate Wi-Fi hub)
+- Paired devices overlap with ZHA coordinator — see dual-path note above
+
+## Configuration Notes
+
+- Thread credentials should match [[home-assistant-connect-zbt-2]]'s Thread network for mesh unity
+- If adding to Apple Home: use Matter pairing code from Aqara app → Apple Home → Add Accessory
+- Hub M3 firmware updates should be applied via Aqara app (not via HA)