FAQ

General Questions

Where can I find more information about ESP-IDF?

Should I run the installer ‘as admin’?

No, the installer does not require elevated rights and should not be run as an administrator. Running the installer with admin privileges is unnecessary and could lead to unintended permission issues.

GUI-Specific Questions

Running Installer in Windows Sandbox

If you intend to run the ESP-IDF installer within a Windows Sandbox environment, you might encounter issues if the ‘WebView2 Runtime’ is not present in the sandbox. The installer relies on WebView2 for its graphical user interface.

To successfully run the installer in Windows Sandbox, you will need to first install the ‘WebView2 Runtime’ within the sandbox environment. You can obtain the installer for the WebView2 Runtime from the following link:

https://developer.microsoft.com/

Download and run the appropriate WebView2 Runtime installer inside the Windows Sandbox before attempting to run the ESP-IDF installer. This will ensure that the necessary components for the GUI are available, allowing the ESP-IDF installer to function correctly.

Can I return to the main page of the installer?

Yes, you can return to the main page by clicking on the Espressif logo in the top-left corner. However, this is not possible during the final steps of installation.

What if the installation fails in simplified mode?

You can either:

Click “Try again” after resolving any issues
Switch to expert mode for more control over the installation process
Check the logs folder for detailed information about the failure

CLI-Specific Questions

What if I want to install a specific version of IDF that is not listed?

You can install any tagged version of ESP-IDF using the -i or --idf-version flag:


eim -i v4.4.1

I am getting the error `/lib64/libm.so.6: version 'GLIBC_2.38' not found`. What should I do?

This error indicates that your Linux system is using an outdated version of the GNU C Library (glibc). However, since the CLI is statically linked, it does not depend on the system’s glibc and should not encounter this issue. If you continue to experience problems, consider updating your Linux distribution to a newer version.

How can I use EIM in CI/CD pipelines?

For GitHub Actions, use the install-esp-idf-action. For other CI/CD systems, use the headless mode with appropriate configuration. See Headless Usage for details.