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

FlagShortDescription
--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.

FlagDescription
--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
--vsockHost the SSH socket over vsock instead of UDS; the vsock port is the default port base plus instance_num
--detachDaemonize: 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

  • minimald accepts but ignores the hidden --stdlib-dir flag.