Platform

Platform architecture

Kyvernon consists of the Kyvernon VMM hypervisor on every host, a replicated control plane, storage and network services, and a compatibility layer for the vSphere APIs. All functions are available through one native API.

Kyvernon architecture in four layers Top layer: clients, namely the web UI, the CLI and existing vSphere tools. Second layer: the native API, with the compatibility layer translating the vSphere protocols into it. Third layer: the control plane, three replicated controllers with inventory, task engine, scheduler, identity and audit log. Bottom layer: hosts, each with a host agent driving Kyvernon VMM, the hypervisor layer in Rust on the processor's hardware virtualization, an OVS/OVN virtual switch and storage drivers, connected to storage pools and the network fabric. Clients Web UI CLI Existing vSphere toolsPowerCLI, Terraform, Ansible, Zabbix, exporters, backup Native API gRPC and REST, OpenAPI 3.1, versioned /v1, watch streams, long-running operations Compatibility layer SOAP /sdk, REST /api, /folder, /nfc Control plane Raft-replicated inventory and configuration, one management domain, no external database InventoryObjects, tags, folders Task engineTasks and events SchedulerExplainable decisions IdentityOIDC, SAML, roles Audit logAppend-only, exportable Host 1 Host agent (Rust): lifecycle, migration, OVS/OVN virtual switch, storage drivers, backup exporter (NBD, dirty bitmaps) Kyvernon VMM: hypervisor layer in Rust Host 2 Same signed, immutable image A/B partitions, verified at boot Kyvernon VMM Host N Design target: 128 hosts per cluster, 2,500 hosts per management domain Kyvernon VMM Storage pools: local ZFS/LVM, NFS, iSCSI, FC multipath; qcow2 by default Network fabric: VLAN, Geneve overlay, routers, gateway firewall

Key facts

ItemDetail
HypervisorKyvernon VMM, written in Rust, runs guests on the hardware virtualization of the host processor through the host kernel
Firmware and security devicesUEFI with Secure Boot, BIOS, virtual TPM 2.0
ConsoleGraphical console in the browser, opened with a WebSocket ticket that works once
BackupPersistent change tracking per disk, NBD export of a consistent snapshot
Live migrationBetween hosts over TLS, in the cluster release Planned
vSphere API196 of 972 vim25 methods plus the REST, datastore and OVF surfaces, see compatibility

Components

ComponentFunction
Kyvernon VMMRuns virtual machines on the hardware virtualization of the host processor
Host agentManages Kyvernon VMM, storage and networking on one host
Control planeInventory, scheduling, high availability, identity, tasks and audit log
Storage servicesStorage pools, virtual disk formats, snapshots, backup export
Network servicesVirtual switches, VLAN and overlay segments, routing, firewall
Compatibility layervSphere SOAP, REST, datastore and OVF endpoints

Kyvernon VMM

Kyvernon VMM is the hypervisor of the platform. It is written in Rust and runs guests directly on Intel VT-x and AMD-V through the host kernel.

Unsafe code is restricted to two isolated modules for kernel calls and memory mapping. All device models are memory-safe Rust.

Guest operating systems at first release: current Linux distributions and Windows Server with virtio drivers. The migration tooling installs virtio drivers in imported guests.

Control plane

The control plane runs as a group of controllers per management domain. Inventory and configuration are replicated with Raft. No external database is required.

Host software

Each host runs one agent process. Hosts boot from a minimal, signed, immutable image with A/B partitions. An upgrade installs to the inactive partition; a failed boot returns to the previous image.

Storage

ItemDetail
Storage poolsLocal directory, ZFS, LVM thin, NFS, iSCSI, Fibre Channel with multipath
Distributed storageCeph RBD, planned for a later release
Disk formatqcow2 by default, raw optional
Change trackingPersistent dirty bitmaps per disk
Backup exportNBD export of a consistent snapshot with changed-block information

Networking

ItemDetail
Virtual switchingOpen vSwitch on every host, OVN across the cluster
SegmentsVLAN and Geneve overlay
RoutingDistributed routers with NAT and gateway firewall
FirewallStateful rules per virtual NIC, based on tags and groups
vSphere objectsStandard switches, distributed switches and port groups

The distributed firewall checks traffic at the network adapter of each virtual machine, on the host where the machine runs, in both directions. Rules use groups, tags and named services, are evaluated in four ordered categories, and apply to provider and tenant scopes. Existing virtual machines move to enforcement in steps: a monitor mode first, then enforcement with a confirmation timer. See how the distributed firewall works.

Product tour

Development build with sample data.

Kyvernon web console showing a virtual machine with state, console thumbnail, guest information and resources
Virtual machine summary with the Console card
Kyvernon graphical console of a virtual machine in a browser dialog with Ctrl+Alt+Del, paste and full screen controls
Graphical console in the browser
Kyvernon snapshot manager listing two snapshots of a virtual machine with revert and remove actions
Snapshot manager
Kyvernon datastore browser listing two cloud images in a folder
Datastore browser
Kyvernon host Monitor tab with CPU usage and CPU ready charts
Host Monitor tab

Interfaces

Kyvernon web console showing a cluster summary with availability, placement and resource usage
Web console, development build with sample data
InterfaceProtocol
Native APIgRPC and REST, OpenAPI 3.1, versioned under /v1
Web UIBrowser, WCAG 2.2 AA
CLIkyvernon command-line client
vSphere endpointsSOAP /sdk, REST /api and /rest, /folder, /nfc
Metrics and tracesPrometheus /metrics, OpenTelemetry
EventsWebhooks with HMAC signatures and CloudEvents, syslog, CEF

Measured figures

MeasurementResultMethod
Network between two virtual machines, 1 TCP stream16 Gbit/siperf3 between two guests on one host over virtio-net, median of 3 runs
Network between two virtual machines, 4 TCP streams25.6 Gbit/sSame setup, 4 parallel streams
Power-on to SSH login18 to 21 sUbuntu 24.04 cloud image with cloud-init, 2 vCPU, 2 GiB, from the power-on request until SSH answers, 3 runs
Linked clone0.19 sMedian of 40 and of 80 clones made through the API
Snapshot including memory1.35 sGuest with 2 GiB, guest paused for 1.30 s
Sequential disk, write and read1,438 and 1,579 MiB/sfio, 1 MiB blocks, queue depth 4, direct I/O, 4 GiB data disk on the host SSD with the host page cache in the path, median of 3 runs
Virtual machines running on one host888 scenario guests plus 80 linked clones started in batches of 10; no limit of the platform was reached, the memory assigned to the measurement was the bound
API response time20 to 40 msMedian of 30 requests each for govc and native API calls against the controller, 7 virtual machines in the inventory

Lab host: Dell R630, 2 x Intel Xeon E5-2630 v4, 121 GiB memory, Ubuntu guests, Kyvernon VMM, measured on 5 November 2026 with a development build. The figures are measurements on one machine, not specifications.

Design targets

ItemTarget
Hosts per cluster128
Hosts per management domain2,500

Published configuration maximums replace these targets once they are measured on reference hardware.