From e1214936bc891084f4cf397dd37dcd2b2964218f Mon Sep 17 00:00:00 2001 From: Petr Gadorek Date: Mon, 23 Mar 2026 11:07:14 +0100 Subject: [PATCH 1/2] docs: Add Homebrew installation instructions for EIM on Linux --- docs/en/get-started/linux-setup.rst | 37 ++++++++++++++++++++++++ docs/zh_CN/get-started/linux-setup.rst | 40 ++++++++++++++++++++++++++ 2 files changed, 77 insertions(+) diff --git a/docs/en/get-started/linux-setup.rst b/docs/en/get-started/linux-setup.rst index 547a829b98c..89e30a24333 100644 --- a/docs/en/get-started/linux-setup.rst +++ b/docs/en/get-started/linux-setup.rst @@ -103,6 +103,43 @@ Then, install the EIM Command Line Interface (CLI) alone, or together with Graph sudo dnf install eim-cli +Linux Installation via Homebrew +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +EIM can also be installed on Linux using `Homebrew `_. This method works on most Linux distributions and is a good alternative if you prefer Homebrew over system package managers. + +First, install Homebrew if you have not already: + +.. code-block:: bash + + /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + +Then add the Espressif tap and install EIM: + +.. code-block:: bash + + # Add the Espressif tap + brew tap espressif/eim + + # Install CLI only + brew install eim + + # Or install GUI (includes CLI) + brew install --cask eim-gui + +To update EIM later: + +.. code-block:: bash + + brew upgrade eim + # or + brew upgrade --cask eim-gui + +.. note:: + + The GUI version requires a graphical environment and may have additional dependencies depending on your Linux distribution. + + Step 3: Install ESP-IDF Using EIM ================================= diff --git a/docs/zh_CN/get-started/linux-setup.rst b/docs/zh_CN/get-started/linux-setup.rst index 39a44e84167..23d7dfcbc0f 100644 --- a/docs/zh_CN/get-started/linux-setup.rst +++ b/docs/zh_CN/get-started/linux-setup.rst @@ -33,6 +33,7 @@ - `下载 EIM`_ - `通过 APT 安装（Debian 发行版）`_ - `通过 DNF 安装（RPM 发行版）`_ +- `通过 Homebrew 安装（Linux）`_ 通过 APT 或 DNF 安装 EIM 便于后续升级更新。 @@ -103,6 +104,45 @@ sudo dnf install eim-cli +.. _install-eim-linux-homebrew: + +通过 Homebrew 安装（Linux） +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +EIM 也可以使用 `Homebrew `_ 在 Linux 上安装。此方法适用于大多数 Linux 发行版，如果您更喜欢 Homebrew 而不是系统包管理器，这是一个很好的替代方案。 + +首先，如果您尚未安装 Homebrew，请安装它： + +.. code-block:: bash + + /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + +然后添加 Espressif tap 并安装 EIM： + +.. code-block:: bash + + # 添加 Espressif tap + brew tap espressif/eim + + # 仅安装 CLI + brew install eim + + # 或安装 GUI（含 CLI） + brew install --cask eim-gui + +稍后更新 EIM： + +.. code-block:: bash + + brew upgrade eim + # 或 + brew upgrade --cask eim-gui + +.. note:: + + GUI 版本需要图形环境，可能还有其他取决于您 Linux 发行版的依赖项。 + + 第三步：使用 EIM 安装 ESP-IDF ================================= From bce32e9a7f1bf161c88dc2e749ff90735254a411 Mon Sep 17 00:00:00 2001 From: Zhang Shuxian Date: Thu, 25 Jun 2026 10:39:55 +0800 Subject: [PATCH 2/2] docs: Update translation for homebrew installation --- docs/en/get-started/linux-setup.rst | 1 + docs/zh_CN/get-started/linux-setup.rst | 16 +++++++--------- 2 files changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/en/get-started/linux-setup.rst b/docs/en/get-started/linux-setup.rst index 89e30a24333..111501c5c1e 100644 --- a/docs/en/get-started/linux-setup.rst +++ b/docs/en/get-started/linux-setup.rst @@ -33,6 +33,7 @@ You can install the EIM using one of the following methods: - `Download the EIM`_ - `Debian-Based Linux Installation via APT`_ - `RPM-Based Linux Installation via DNF`_ +- `Linux Installation via Homebrew`_ Installing via APT or DNF allows you to easily keep EIM up to date with a single command. diff --git a/docs/zh_CN/get-started/linux-setup.rst b/docs/zh_CN/get-started/linux-setup.rst index 23d7dfcbc0f..547018068be 100644 --- a/docs/zh_CN/get-started/linux-setup.rst +++ b/docs/zh_CN/get-started/linux-setup.rst @@ -33,7 +33,7 @@ - `下载 EIM`_ - `通过 APT 安装（Debian 发行版）`_ - `通过 DNF 安装（RPM 发行版）`_ -- `通过 Homebrew 安装（Linux）`_ +- `通过 Homebrew 安装`_ 通过 APT 或 DNF 安装 EIM 便于后续升级更新。 @@ -104,14 +104,12 @@ sudo dnf install eim-cli -.. _install-eim-linux-homebrew: +通过 Homebrew 安装 +~~~~~~~~~~~~~~~~~~~~~~~ -通过 Homebrew 安装（Linux） -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +也可以使用 `Homebrew `_ 在 Linux 上安装 EIM，此方法适用于大多数 Linux 发行版。如果不想使用系统包管理器，Homebrew 也是一个不错的选择。 -EIM 也可以使用 `Homebrew `_ 在 Linux 上安装。此方法适用于大多数 Linux 发行版，如果您更喜欢 Homebrew 而不是系统包管理器，这是一个很好的替代方案。 - -首先，如果您尚未安装 Homebrew，请安装它： +首先，如果尚未安装 Homebrew，请先安装： .. code-block:: bash @@ -130,7 +128,7 @@ EIM 也可以使用 `Homebrew `_ 在 Linux 上安装。此方 # 或安装 GUI（含 CLI） brew install --cask eim-gui -稍后更新 EIM： +后续更新 EIM： .. code-block:: bash @@ -140,7 +138,7 @@ EIM 也可以使用 `Homebrew `_ 在 Linux 上安装。此方 .. note:: - GUI 版本需要图形环境，可能还有其他取决于您 Linux 发行版的依赖项。 + GUI 版本需要图形环境，不同的 Linux 发行版可能有不同的额外依赖。 第三步：使用 EIM 安装 ESP-IDF