Volant
HomeDocsAPI Reference
HomeDocsAPI Reference
  1. References
  • 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. References

kestrel(agent)

Kestrel is the in-guest agent and default PID1 for initramfs default mode.
Key behavior (see fledge/internal/builder/embed/init.c and agent code):
When used as PID1, it prepares the guest environment and exposes a control socket over vsock.
It can proxy HTTP requests from volantd to workloads running in the guest, enabling fully isolated vsock-only deployments.
The agent receives runtime arguments via the kernel cmdline, encoded by the orchestrator, including:
runtime (pluginspec.RuntimeKey)
api host/port (pluginspec.APIHostKey/APIPortKey)
encoded manifest (pluginspec.CmdlineKey)
For most users, there are no CLI flags to pass directly to kestrel; configuration is provided through the manifest and per-VM config.
Modified at 2025-10-05 17:47:51
Previous
volantd (server)
Next
Glossary
Built with