How firecracker-microvm/firecracker works
Firecracker is a host-side virtual machine monitor for creating and running isolated microVMs, with KVM as its primary backend and a Nitro Sandbox option. The main workflow is a host operator or runtime configuring a VM through the API, then Firecracker building it and driving its event loop. The graph also preserves device, guest-memory, snapshot, and isolation capabilities documented in the README. Some subsystem paths come from the tree rather than inspected implementations; those relationships are omitted where evidence does not establish the call direction.
Main entry points: main.rs Firecracker Process · device.rs Virtio Framework · vm.rs VM State · mod.rs HTTP API
Components 19
Host Control
- HTTP API
src/firecracker/src/api_server/mod.rs - API Adapter
src/firecracker/src/api_server_adapter.rs - Firecracker Process
src/firecracker/src/main.rs - VM Configuration
src/vmm/src/vmm_config
VM Runtime
- MicroVM Builder
src/vmm/src/builder.rs - VM State
src/vmm/src/vstate/vm.rs - Guest Memory
src/vmm/src/vstate/memory.rs - KVM Backend
src/vmm/src/vstate/kvm.rs - Nitro Sandbox
src/vmm/src/nitro_enclave
Guest Devices
- Virtio Framework
src/vmm/src/devices/virtio/device.rs - Block Device
src/vmm/src/devices/virtio/block/virtio/worker.rs - Network Device
src/vmm/src/devices/virtio/net/device.rs - Vsock Device
src/vmm/src/devices/virtio/vsock/event_handler.rs
State and Metadata
- Guest Metadata
src/vmm/src/mmds - Snapshots
src/vmm/src/snapshot - Metrics
src/firecracker/src/metrics.rs
Isolation
- Jailer
src/jailer/src/main.rs - Seccomp Filters
src/firecracker/src/seccomp.rs
Other components
- Host Operator
Connections 14
- Host Operator → HTTP API: configures VM
README.md - HTTP API → VM Configuration: sets resources
README.md - Firecracker Process → HTTP API: starts API
src/firecracker/src/main.rs - Firecracker Process → API Adapter: uses adapter
src/firecracker/src/main.rs - Firecracker Process → MicroVM Builder: builds microVM
src/firecracker/src/main.rs - Firecracker Process → Metrics: starts metrics
src/firecracker/src/main.rs - Firecracker Process → Seccomp Filters: applies filters
src/firecracker/src/main.rs - VM Configuration → MicroVM Builder: configures
- MicroVM Builder → VM State: creates VM
- VM State → KVM Backend: uses backend
- VM State → Nitro Sandbox: selects backend
- Virtio Framework → Block Device: hosts device
src/vmm/src/devices/virtio/block/virtio/worker.rs - Virtio Framework → Network Device: hosts device
- Virtio Framework → Vsock Device: hosts device
src/vmm/src/devices/virtio/vsock/event_handler.rs