diff --git a/docs/build/tools/localnet.mdx b/docs/build/tools/localnet.mdx index 4e5a451fb8..6f7e576b8c 100644 --- a/docs/build/tools/localnet.mdx +++ b/docs/build/tools/localnet.mdx @@ -49,18 +49,17 @@ docker run -it --rm -p8544-8548:8544-8548 ghcr.io/oasisprotocol/sapphire-localne docker run -it --rm -p8544-8548:8544-8548 --platform linux/x86_64 ghcr.io/oasisprotocol/sapphire-localnet ``` -:::info macOS Startup Issue on Apple Silicon +:::info Apple Silicon on macOS -On Apple Silicon Macs running macOS 26 (Tahoe) or later, the `sapphire-localnet` Docker -image may hang on startup with peer authentication errors (e.g., -`chacha20poly1305: message authentication failed`). +Rosetta must be **enabled** in Docker Desktop for `sapphire-localnet` to work +on Apple Silicon Macs. QEMU emulation is not supported. Go to +`Settings > General > Virtual Machine Options` and verify that +"Use Rosetta for x86_64/amd64 emulation on Apple Silicon" is checked (this is +the default). -This is due to a bug in Rosetta 2's x86_64 emulation. The workaround is to -disable Rosetta in Docker Desktop settings, which makes Docker use QEMU -instead. +Make sure to pull the latest version of the image: -Go to `Settings > Virtual Machine Options` and disable -"Use Rosetta for x86/amd64 emulation on Apple Silicon". +`docker pull ghcr.io/oasisprotocol/sapphire-localnet` :::