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

Security and Limits

Security Model

  • Isolation: Cloud Hypervisor microVMs with dedicated kernel per VM
  • API protections:
    • VOLANT_API_KEY header (X-Volant-API-Key) or api_key query param
    • VOLANT_API_ALLOW_CIDR to limit incoming clients
  • Device passthrough:
    • VFIO flow explicitly validates allowlists and IOMMU groups; devices unbound on VM destroy

Resource Limits

  • Per-VM

    • CPU cores and memory are explicit in VM spec; launcher passes boot=, size=
    • Disk attachments are explicit; rootfs default writable, additional disks can be readonly
  • IPAM

    • Simple in-DB pool derived from configured subnet; excludes network/broadcast/host IP

Failure Modes

  • Launch failures

    • Cloud-init build or media fetch checksum mismatch: VM creation rolled back, artifacts removed
    • Tap/bridge errors: tap cleaned up, DB rolled back
  • Agent unavailable

    • Proxy endpoints return 502/503; does not impact VM lifecycle
  • Process crashes

    • Instance Wait() monitored; status transitioned to crashed/stopped; events published; taps and artifacts cleaned
Modified at 2025-10-05 17:47:06
Previous
Boot and Runtime
Next
Extensibility
Built with