neilphan98/hearth-home-assistant repository overview

⁠HEARTH Home Assistant

Home Assistant: the building's SOC / impact dashboard over MQTT + Matter.

Real-device analogue: Home Assistant (the real smart-building/home automation platform).

Protocol / ports: HTTP UI (TCP 8123); MQTT client; Matter via the Matter Server.

⁠What it does / how it works

Real Home Assistant. In HEARTH it is the operations/impact view: it ingests MQTT telemetry and Matter state and shows doors/HVAC/MQTT impact live, so an attack's effect is visible.

⁠Functions

• Web dashboard (8123)
• MQTT + Matter integrations
• Impact/SOC visualisation

⁠How to use

Browse http://<ip>:8123. Point MQTT at your broker; point Matter at a Matter Server (5580).

⁠Use in GNS3

• Import the matching .gns3a (File > Import appliance), or docker pull neilphan98/hearth-home-assistant:stable.
• Drag onto your topology, wire to a switch/hub, start. Console: telnet.
• Adapters: 1. Category: guest.

⁠Default environment (per node)

MQQ1_IP=192.168.6.15
MQQ1_PREFIX=24
MQQ1_GW=192.168.6.1
MQQ1_IP6=fd11:1111:1111:6::f
MQQ1_IP6_PREFIX=64
MQQ1_GW6=fd11:1111:1111:6::1
MQTT_BROKER=192.168.6.10

Current release: stable (docker pull neilphan98/hearth-home-assistant:stable)

Part of the HEARTH Tower commercial-building IoT/OT security testbed. Image tags are immutable per release (1.0, 1.1, ...), so updating the device list never changes nodes you already placed. See the HEARTH bundle for all devices + guides.