> ## Documentation Index
> Fetch the complete documentation index at: https://docs.microsandbox.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS

> Diagnose Apple Silicon and local runtime setup on macOS

microsandbox local sandboxes on macOS require Apple Silicon. Intel Macs are not supported for the local runtime.

## Quick checks

Start with the doctor command for the local setup checks:

```bash theme={null}
msb doctor
```

Confirm that the host is Apple Silicon:

```bash theme={null}
uname -m
```

The expected result is `arm64`. If the result is `x86_64`, the machine is an Intel Mac or the command is running under an x86\_64 environment. microsandbox needs Apple Silicon; Rosetta does not make an Intel Mac supported for local sandboxes.

## Hardware virtualization

Unlike Linux and Windows, macOS does not require enabling a separate KVM or Windows Hypervisor Platform feature. Apple Silicon Macs include the hypervisor support that microsandbox uses.

If sandbox startup fails on an Apple Silicon Mac, first run `msb doctor`, then try a fresh terminal session so your current `PATH` is visible. If the doctor reports missing runtime files, refresh them with:

```bash theme={null}
msb self update
```

## Runtime path

The default runtime root is `~/.microsandbox`. The CLI binary lives under `bin/msb`, and the runtime library lives under `lib/libkrunfw.dylib`.

If macOS is finding a stale binary, check the command path:

```bash theme={null}
which msb
```