Skip to main content
Hosts are the KVM processes that build artifacts and run microVMs. Nothing here is persisted: the server answers from the heartbeats hosts publish over NATS and from asking every host directly. These RPCs are on functions.v1.FunctionsService, with messages in protos/functions/v1/host.proto. See Architecture for how hosts and servers talk.

RPCs

ListInstances

Takes an optional function_id. Empty lists every function’s instances. The server asks every host over NATS and gathers the replies that arrive within 500ms, so a slow host can be missing from one response. Instances belong to the caller’s tenant only, ordered by started_at. If the request cannot be sent, the call is unavailable. Instances die with the host process.

ListHosts

Takes no fields. Returns every host that heartbeated within the last 10 seconds, sorted by hostname. Hosts are shared by every tenant of the deployment, so the list is not tenant-scoped.

GetHost

Takes no fields. Returns the first live host by hostname, or unavailable when no host is live. It predates multiple hosts and ListHosts supersedes it.