Guest architecture (arm64 / amd64, TCG)

Default guest arch matches the host (Apple Silicon → arm64, Intel/AMD → amd64).

Select guest arch

# native (default)
grain new --wait agent

# x86_64 guest (on Apple Silicon this uses QEMU TCG — slower, not Apple Rosetta)
grain new --arch amd64 -i ubuntu-cloud --wait ssh

Config default:

guest_arch: amd64   # or arm64 / empty for host

Images

Use an image built for the guest ISA. Pulling golden grain-ubuntu matches the host arch. For cross-arch boots, pull or import a matching cloud image (for example Ubuntu cloud amd64 on an arm64 Mac).

Rosetta note

Apple’s Rosetta for Linux is a Virtualization.framework feature, not QEMU HVF. On Apple Silicon, grain runs amd64 guests with QEMU TCG. That works for many CI and debug cases; it is not Rosetta translation inside a VZF VM.

See also

• Images