Noderax Docs
Architecture

Agent Architecture

Understand the Go agent runtime, its connection to the control plane, and how it participates in node install, metrics, tasks, and terminals.

Agent Architecture

The agent is the runtime that lives on each managed node.

Core duties

  • register and authenticate with the control plane
  • emit heartbeat and metrics
  • accept tasks and package operations
  • proxy terminal IO
  • report node install progress and final enrollment state
binary entrypoint
service composition and enrollment/bootstrap flow
control-plane transport client
terminal reverse-session handling

Runtime composition

Release model

The agent has its own release line and rollout system. It is updated through the agent updates surface, not through control-plane self-update.

The agent is part of the product runtime but not part of the installer-managed control-plane bundle lifecycle. Its operational update surface remains rollout based.

On this page