From bc3befcaea32db15f0596f07e050c5fce8ca9949 Mon Sep 17 00:00:00 2001
From: Abhishek Uniyal <56363630+uniyalabhishek@users.noreply.github.com>
Date: Fri, 13 Mar 2026 19:49:06 +0530
Subject: [PATCH] fix: localnet macos doc

---
 docs/build/tools/localnet.mdx | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

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`
 
 :::