Alternative File Downloads; Customizing The Tools Installation Path; Step 4. Set Up The Environment Variables - Espressif ESP32-S2 Programming Manual

Chapter 1. Get Started
cd ~/esp/esp-idf
./install.fish esp32s2
Note: To install tools for multiple targets you can specify those targets at once. For example: ./install.sh
esp32,esp32c3,esp32s3. To install tools for all supported targets, run the script without specifying targets
./install.sh or use ./install.sh all.

1.7.3 Alternative File Downloads

The tools installer downloads a number of files attached to GitHub Releases. If accessing GitHub is slow then it is
possible to set an environment variable to prefer Espressif's download server for GitHub asset downloads.
Note: This setting only controls individual tools downloaded from GitHub releases, it doesn't change the URLs
used to access any Git repositories.
Windows
To prefer the Espressif download server when running the ESP-IDF Tools Installer, mark the Use Espressif down-
load mirror instead of GitHub in the screen Select Components section Optimization.
Linux and macOS
To prefer the Espressif download server when installing tools, use the following sequence of commands when running
install.sh:
cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"
./install.sh

1.7.4 Customizing the tools installation path

The scripts introduced in this step install compilation tools required by ESP-IDF inside the user home directory:
$HOME/.espressif on Linux and macOS, %USERPROFILE%\.espressif on Windows. If you wish to
install the tools into a different directory, set the environment variable IDF_TOOLS_PATH before running the
installation scripts. Make sure that your user account has sufficient permissions to read and write this path.
If changing the IDF_TOOLS_PATH, make sure it is set to the same value every time the Install script (install.
bat, install.ps1 or install.sh) and an Export script (export.bat, export.ps1 or export.sh)
are executed.

1.8 Step 4. Set up the environment variables

The installed tools are not yet added to the PATH environment variable. To make the tools usable from the command
line, some environment variables must be set. ESP-IDF provides another script which does that.
Espressif Systems 63 Release v4.4
Submit Document Feedback