Skip to content

Commit bc3befc

Browse files
fix: localnet macos doc
1 parent bfd1f91 commit bc3befc

1 file changed

Lines changed: 8 additions & 9 deletions

File tree

docs/build/tools/localnet.mdx

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -49,18 +49,17 @@ docker run -it --rm -p8544-8548:8544-8548 ghcr.io/oasisprotocol/sapphire-localne
4949
docker run -it --rm -p8544-8548:8544-8548 --platform linux/x86_64 ghcr.io/oasisprotocol/sapphire-localnet
5050
```
5151

52-
:::info macOS Startup Issue on Apple Silicon
52+
:::info Apple Silicon on macOS
5353

54-
On Apple Silicon Macs running macOS 26 (Tahoe) or later, the `sapphire-localnet` Docker
55-
image may hang on startup with peer authentication errors (e.g.,
56-
`chacha20poly1305: message authentication failed`).
54+
Rosetta must be **enabled** in Docker Desktop for `sapphire-localnet` to work
55+
on Apple Silicon Macs. QEMU emulation is not supported. Go to
56+
`Settings > General > Virtual Machine Options` and verify that
57+
"Use Rosetta for x86_64/amd64 emulation on Apple Silicon" is checked (this is
58+
the default).
5759

58-
This is due to a bug in Rosetta 2's x86_64 emulation. The workaround is to
59-
disable Rosetta in Docker Desktop settings, which makes Docker use QEMU
60-
instead.
60+
Make sure to pull the latest version of the image:
6161

62-
Go to `Settings > Virtual Machine Options` and disable
63-
"Use Rosetta for x86/amd64 emulation on Apple Silicon".
62+
`docker pull ghcr.io/oasisprotocol/sapphire-localnet`
6463

6564
:::
6665

0 commit comments

Comments
 (0)