Skip to content

Architecture

Architecture overview

How mvm builds and runs secure local microVM workloads.

mvm keeps build, admission, runtime, and guest control boundaries explicit.

SDK / CLI
-> mvm local runtime
-> builder VM for Linux build work
-> signed plan admission
-> microVM backend
-> guest agent and workload
ComponentOwns
SDKAuthoring, lifecycle calls, result surfaces, and local transport choice.
mvmBuild handoff, launch admission, backend lifecycle, guest protocol, local audit.
Builder VMLinux Nix evaluation, builds, image assembly, microVM-specific tooling.
Guest agentIn-guest process, filesystem, readiness, and telemetry RPC.

See Control surfaces for the current CLI, SDK, console, and guest RPC entry points.

The runtime should be understandable from evidence:

  • the artifact identity is known before launch;
  • the plan binds resources and policy references;
  • the audit chain records runtime decisions;
  • credentials are references and grants;
  • network access is explicitly mediated;
  • checkpoint and snapshot restore carry backend-specific integrity evidence.