diff --git a/README.md b/README.md
index d6298e194..aa4496e5d 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,7 @@ To run the end-to-end tests, run:
 ```bash
 MANIFEST=devnet1 make e2e-run
 ```
+_If the above command fails, [see the troubleshooting section](./e2e/README.md#troubleshooting)._
 
 To start a devnet, run:
 
diff --git a/e2e/README.md b/e2e/README.md
index ab8ad00fb..0e56a572f 100644
--- a/e2e/README.md
+++ b/e2e/README.md
@@ -48,3 +48,18 @@ Auxiliary commands:
 * `logs`: outputs all node logs.
 
 * `tail`: tails (follows) node logs until canceled.
+
+
+## Troubleshooting
+**MacBook E2E test fails to start docker container**
+If you are experiencing an issue running the e2e tests and the error output looks like this:
+```
+Error response from daemon: no match for platform in manifest
+```
+This error is known to happen on a freshly installed MacBook, we are investigating the underlying issue, but meanwhile, there is a workaround:
+1. Clean all the build images `docker system prune -a -f --volumes`
+2. Set the platform env: `export DOCKER_DEFAULT_PLATFORM=linux/amd64`
+3. Rerun docker build: `make build-docker`
+4. Run tests again: `make e2e-ci` or any other tests using the e2e command.
+
+Please let the team know if you experienced the above issue.