From 8f7f3dec26fad4d5cd294d95f0e483b8d448195e Mon Sep 17 00:00:00 2001
From: Puru Tuladhar <purushottam.tuladhar@covergo.com>
Date: Tue, 21 Jul 2026 21:08:05 +0545
Subject: [PATCH] Add rosetta installation instruction

---
 docs/how-to.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/how-to.md b/docs/how-to.md
index 8ec845dab..7892a3bf7 100644
--- a/docs/how-to.md
+++ b/docs/how-to.md
@@ -86,6 +86,12 @@ Linux c0376e0a-0bfd-4eea-9e9e-9f9a2c327051 6.1.68 #1 SMP Mon Mar 31 18:27:51 UTC
 %
 </pre>
 
+Running `amd64` images requires Rosetta. If you receive an installation error, navigate to `/System/Library/CoreServices/` and open `Rosetta 2 Updater.app` to install it.
+
+<pre>
+Error: failed to bootstrap container ... "Rosetta is not installed" ...
+</pre>
+
 The command to push your multiplatform image to a registry is no different than that for a single-platform image:
 
 ```bash