minvmd - VM daemon
minvmd is the host daemon that brings up a Linux microVM via libkrun
(macOS/HVF or Linux/KVM) and supervises the
minimald instance running inside it. On macOS it is
the only session backend; on Linux it is selected with min --provider local-minvmd
(see min).
Generated from --help at 3a05252c.
Global flags
| Flag | Description |
|---|---|
--minimal-state-dir <PATH> | Override the state dir base (default: $XDG_STATE_HOME/minimal). Runtime files live under <dir>/providers/local-minvmd0/ |
Commands
Two commands bring the VM up. run (alias start) is the
lifecycle-managed supervisor: it drives the daemon’s state transitions and
supports --detach for background operation, so it is the usual entry
point. boot is a lower-level bring-up that skips lifecycle state, used
mainly for diagnostics.
boot
minvmd boot [--foreground]Boots the microVM and waits until the guest is up. --foreground stays
in the foreground until the VMM child exits.
run (alias: start)
minvmd run [--detach] [--timeout <SECONDS>]Starts the microVM supervisor (foreground by default).
| Flag | Description |
|---|---|
--detach | Spawn the supervisor in the background and return once the host UDS is accepting connections |
--timeout <SECONDS> | Timeout in seconds to wait for the host UDS when using --detach (default: 8) |
status
minvmd status [--json]Prints daemon status. Exit code: 0 if running, 1 if stopped, 2 on
lock contention. --json prints status as a JSON object.
config show
minvmd config show [--json]Prints the effective per-VM resource configuration and each value’s
source. --json prints it as a JSON object.
config set
minvmd config set [--vcpus <N>] [--ram-mib <N>]Validates and persists resource parameters, applied on the next boot.
| Flag | Description |
|---|---|
--vcpus <N> | Number of virtual CPUs |
--ram-mib <N> | Guest RAM in MiB |
stop
minvmd stopStops the running daemon gracefully.
completions
minvmd completions <SHELL>Generates a shell tab-completion script. Supported shells include bash, zsh,
elvish, fish.