diff --git a/docs/en/get-started/linux-macos-setup.rst b/docs/en/get-started/linux-macos-setup.rst
index f71f9c00ba..db815fc0f9 100644
--- a/docs/en/get-started/linux-macos-setup.rst
+++ b/docs/en/get-started/linux-macos-setup.rst
@@ -1,4 +1,4 @@
-********************************************
+********************************************
 Standard Toolchain Setup for Linux and macOS
 ********************************************
 
@@ -76,6 +76,25 @@ ESP-IDF will use the version of Python installed by default on macOS.
 
    Then you will need to install the XCode command line tools to continue. You can install these by running ``xcode-select --install``.
 
+Apple M1 Users
+~~~~~~~~~~~~~~
+
+If you use Apple M1 platform and see an error like this::
+
+      WARNING: directory for tool xtensa-esp32-elf version esp-2021r2-patch3-8.4.0 is present, but tool was not found
+      ERROR: tool xtensa-esp32-elf has no installed versions. Please run 'install.sh' to install it.
+
+or::
+
+      zsh: bad CPU type in executable: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2-patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
+
+Then you will need to install Apple Rosetta 2 by running
+
+.. code-block:: bash
+
+    /usr/sbin/softwareupdate --install-rosetta --agree-to-license
+
+
 Installing Python 3
 ~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/zh_CN/get-started/linux-macos-setup.rst b/docs/zh_CN/get-started/linux-macos-setup.rst
index 9d4cba7bfd..65ddf24ada 100644
--- a/docs/zh_CN/get-started/linux-macos-setup.rst
+++ b/docs/zh_CN/get-started/linux-macos-setup.rst
@@ -76,6 +76,25 @@ ESP-IDF 将使用 macOS 上默认安装的 Python 版本。
 
     则必须安装 XCode 命令行工具，可运行 ``xcode-select --install`` 命令进行安装。
 
+Apple M1 用户
+~~~~~~~~~~~~~~~~~~
+
+如果您使用的是 Apple M1 系列且看到如下错误提示::
+
+      WARNING: directory for tool xtensa-esp32-elf version esp-2021r2-patch3-8.4.0 is present, but tool was not found
+      ERROR: tool xtensa-esp32-elf has no installed versions. Please run 'install.sh' to install it.
+
+或者::
+
+      zsh: bad CPU type in executable: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2-patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
+
+您需要运行如下命令来安装 Apple Rosetta 2：
+
+.. code-block:: bash
+
+    /usr/sbin/softwareupdate --install-rosetta --agree-to-license
+
+
 安装 Python 3
 ---------------------------------------------