Skip to content
mvm

Guides

macOS sandbox debugging

Debug local macOS workflows while keeping Linux runtime work in the builder VM.

macOS is a supported local development target. Linux-specific build and runtime work still belongs inside the builder VM.

Checklist

Section titled “Checklist”
  • Use host cargo for checks that compile cleanly.
  • Use the builder VM for Nix builds and microVM operations.
  • Keep worktree state isolated with MVM_HOME, CARGO_TARGET_DIR, and CARGO_HOME.

Useful commands

Section titled “Useful commands”
Terminal window
mvmctl doctor
mvmctl machine logs <name>
mvmctl machine boot-report <name>

When debugging runtime behavior, name the backend and platform in bug reports.