minimald - host daemon
minimald is the Minimal host daemon. It creates and supervises the
sandboxed sessions that the min CLI connects to, speaking
SSH over a Unix domain socket (or vsock when hosted inside the minvmd
microVM). End users normally never run it by hand: min auto-starts a
native daemon on Linux, and minvmd supervises it
inside the microVM.
Generated from --help at 3a05252c.
Global flags
| Flag | Short | Description |
|---|---|---|
--minimal-state-dir <PATH> | Override the directory where state is stored (default: $XDG_STATE_HOME/minimal) | |
--minimal-cache-dir <PATH> | Override the directory where artifacts are cached (default: $XDG_CACHE_HOME/minimal) |
Commands
run
minimald run [OPTIONS]
Runs the minimald server in the foreground.
| Flag | Description |
|---|---|
--instance-num <N> | Instance number for this minimald; determines client-relevant paths under <minimal_state_dir>/providers/local-minimald<N>. The SSH socket is accessible as ssh.sock. Default: 0 |
--vsock | Host the SSH socket over vsock instead of UDS; the vsock port is the default port base plus instance_num |
--detach | Daemonize: spawn minimald in a new session (setsid) and return once the SSH socket accepts connections, or an 8s timeout elapses. Used by the min CLI to auto-start a native daemon on Linux |
--gvproxy-bin <PATH> | Path to the gvproxy (“gvisor-tap-vsock”) binary used for networking. Defaults to the installed location: the user-local bin/gvproxy-min the installer stamps, else the system install path. |
completions
minimald completions <SHELL>
Generates a shell tab-completion script for minimald. Supported shells include
bash, zsh, elvish, fish. Usage:
source <(minimald completions bash).
Known issues
minimaldaccepts but ignores the hidden--stdlib-dirflag.