Merge branch 'docs/eim-homebrew-support' into 'master'

docs: Add Homebrew installation instructions for EIM on Linux

Closes DOC-14831

See merge request espressif/esp-idf!46916
This commit is contained in:
Roland Dobai
2026-06-25 08:14:31 +02:00
2 changed files with 76 additions and 0 deletions
+38
View File
@@ -33,6 +33,7 @@ You can install the EIM using one of the following methods:
- `Download the EIM`_ - `Download the EIM`_
- `Debian-Based Linux Installation via APT`_ - `Debian-Based Linux Installation via APT`_
- `RPM-Based Linux Installation via DNF`_ - `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. Installing via APT or DNF allows you to easily keep EIM up to date with a single command.
@@ -103,6 +104,43 @@ Then, install the EIM Command Line Interface (CLI) alone, or together with Graph
sudo dnf install eim-cli sudo dnf install eim-cli
Linux Installation via Homebrew
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
EIM can also be installed on Linux using `Homebrew <https://brew.sh/>`_. 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 Step 3: Install ESP-IDF Using EIM
================================= =================================
+38
View File
@@ -33,6 +33,7 @@
- `下载 EIM`_ - `下载 EIM`_
- `通过 APT 安装(Debian 发行版)`_ - `通过 APT 安装(Debian 发行版)`_
- `通过 DNF 安装(RPM 发行版)`_ - `通过 DNF 安装(RPM 发行版)`_
- `通过 Homebrew 安装`_
通过 APT 或 DNF 安装 EIM 便于后续升级更新。 通过 APT 或 DNF 安装 EIM 便于后续升级更新。
@@ -103,6 +104,43 @@
sudo dnf install eim-cli sudo dnf install eim-cli
通过 Homebrew 安装
~~~~~~~~~~~~~~~~~~~~~~~
也可以使用 `Homebrew <https://brew.sh/>`_ 在 Linux 上安装 EIM,此方法适用于大多数 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 第三步:使用 EIM 安装 ESP-IDF
================================= =================================