Reference · As of 2026-09-19

Hannah Infrastructure Map

Every runtime component of the Hannah stack and how they talk to each other — from the satellite in the living room to the last HTTP request to the update server. Line color encodes the protocol, not importance.

Click the legend to filter by protocol · hover a box to highlight its connections · component names link into the docs.

Satellites connect via UDP either directly or through the Go proxy to Hannah Core, and share an MQTT control channel with it; Core in turn speaks gRPC with four standalone services (ioBroker adapter, Telegram, VoiceID, timer service, WebUI) and HTTP with two more (asset server, update server). hannah-proto supplies the shared schema for every gRPC call but isn't itself a runtime participant.
UDP · raw audio stream
gRPC · typed calls / bidi streams
MQTT · pub/sub control topics
HTTP · assets & firmware
Not kept in sync automatically — update this map by hand after bigger architecture changes (new services, protocol changes).