Architecture

Caution

Full architecture page with Mermaid diagrams lands in Sprint 36 (DOCS.9).

LinkMesh has three runtime components:

• Server — embedded Go binary; web UI, API, gitops-backed config store
• Agent — gRPC management client on each host (LinkMesh-native path)
• Collector — the OTel runtime (Grafana Alloy or otelcol-contrib)

Config flows from the UI through the server (writes YAML to the gitops repo), then out to agents via gRPC or OpAMP, which apply it to the local collector. Metrics flow back via heartbeats.