Skip to content

Unikraft Unikernel

Unikraft unikernels are lightweight, single-purpose machine images built with the Unikraft framework. They boot via the DirectKernel mode, where QEMU loads the kernel ELF binary directly.

Import Image

sherpa server image import \
  --src <path-to-kernel.elf> \
  --version <version> \
  --model unikraft_unikernel

Default Node Parameters

Property Value
Kind Unikernel
CPU 1
RAM 512 MiB
Boot Mode DirectKernel
ZTP Method None
Management Interface eth0
Interface Driver virtio

Example Manifest

name = "unikraft-unikernel"

nodes = [
  { name = "dev01", model = "unikraft_unikernel", version = "v1.0.0", kernel_cmdline = "/usr/bin/nginx", ready_port = 80 },
]

Node Access

sherpa console <node-name>

Notes

  • Boot mode is direct_kernel — the kernel ELF binary is loaded directly by QEMU
  • Use kernel_cmdline to specify the application entry point or pass runtime arguments to the unikernel
  • Use ready_port to have Sherpa wait for a TCP port to become available before marking the node as ready
  • Uses DHCP for IP assignment with static MAC-based binding on the management router