Volant
HomeDocsAPI Reference
HomeDocsAPI Reference
  1. Architecture
  • Introduction
    • Why Volant
    • Introduction
  • Getting Started
    • Installation
    • Quick Start: Initramfs Strategy
    • Quick Start: Rootfs Strategy
  • Guides
    • Networking
    • Cloud-Init
    • Deployments
    • GPU Passthrough
    • Troubleshooting
  • Plugin Development
    • Overview
    • Initramfs Plugins
    • OCI/Rootfs Plugins
  • Architecture
    • Overview
    • Components
    • Data Flow
    • Networking
    • Boot and Runtime
    • Security and Limits
    • Extensibility
  • References
    • Plugin Manifest Schema
    • Fledge.toml Schema
    • VFIO API
    • volar(cli)
    • volantd (server)
    • kestrel(agent)
    • Glossary
  • Development
    • Contributing
    • Security
  1. Architecture

Boot and Runtime

Kernel Selection#

Launcher preference:
If LaunchSpec.KernelOverride set → use that path
Else if Initramfs present → use vmlinux (uncompressed)
Else → use bzImage (compressed)
Code: internal/server/orchestrator/cloudhypervisor/launcher.go (kernelSrc selection)

Boot Media#

Initramfs
Manifest.Initramfs.url → required
Optional checksum (sha256:...)
Fastest boot path; pairs well with kestrel agent
RootFS
Manifest.RootFS.url → required
Optional checksum (sha256:...)
Attached as writable disk; default device/fstype set when missing (vda/ext4)

Cloud-Init#

When configured (manifest or overrides), cloud-init NoCloud is built and attached as read-only disk (CIDATA)
Code: internal/server/orchestrator/cloudinit/builder.go
Inputs: user-data, meta-data, optional network-config

Kernel Command Line#

Base args set by orchestrator (ip=... if managed, console, panic, etc.)
Additional runtime args from pluginspec constants (runtime, api_host, api_port, plugin, encoded manifest)
Code: orchestrator.go buildKernelCmdline/appendKernelArgs, launcher assembles --cmdline

Process Model#

Cloud Hypervisor process managed by runtime.Instance
Wait channel for exit, graceful termination (SIGTERM, then SIGKILL on timeout)
Serial console via UNIX socket per VM
Artifacts cleaned on stop (kernel/initramfs/rootfs/serial)
Modified at 2025-10-05 17:47:02
Previous
Networking
Next
Security and Limits
Built with