KEkernel

Get host capabilities

Changed on

Returns machine-readable host capabilities: server and API version, host OS/architecture, every runtime available on this host with its per-runtime feature IDs, the configured default runtime and whether it is available, guest networking model and host gateway, supported image platforms, and stable server-level feature IDs.

Runtime-derived values reflect the actual host (for example, snapshot and standby support on macOS is gated on the host OS version), so clients can gate behavior on capabilities without hard-coding hypervisor knowledge.

get/capabilities

Request

  • Base URL
    http://localhost:4973
  • URL
    http://localhost:4973/capabilities
  • Auth
    HTTP bearer

Response

Host capabilities

featuresstring[] required

Stable server-level feature IDs: API surfaces this server exposes regardless of which runtime backs an instance. Always present: "instances", "images", "builds", "volumes", "ingress", "exec", "logs". Host-conditional: "devices" (device passthrough management, Linux hosts only) and "rosetta-emulation" (Apple Silicon macOS hosts with Rosetta currently installed, per the same availability probe launches enforce). Per-runtime features are reported under each runtimes[] entry.

Example response

{
  "server": {
    "version": "76a2fdb3",
    "api_version": "0.2.0"
  },
  "host": {
    "os": "linux",
    "arch": "arm64"
  },
  "default_runtime": {
    "name": "cloud-hypervisor"
  },
  "runtimes": [
    {
      "name": "cloud-hypervisor"
    }
  ],
  "network": {
    "gateway": "10.100.0.1",
    "subnet": "10.100.0.0/16"
  },
  "images": {
    "platforms": [
      "linux/arm64",
      "linux/amd64"
    ],
    "default_platform": "linux/arm64"
  }
}

Changes