Esp Idf Updates & Release Notes

Documentation for IDF v5.4.3 is available at https://docs.espressif.com/projects/esp-idf/en/v5.4.3/

ESP-IDF v5.4.3 is a bugfix release for ESP-IDF v5.4.

Obtaining v5.4.3

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.4.3 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.4.3
cd esp-idf-v5.4.3/

This is the recommended way of obtaining v5.4.3 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.4.3.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.4.3/esp-idf-v5.4.3.zip

Major changes …

Documentation for IDF v5.2.6 is available at https://docs.espressif.com/projects/esp-idf/en/v5.2.6/

ESP-IDF v5.2.6 is a bugfix release for ESP-IDF v5.2.

Obtaining v5.2.6

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.2.6 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.2.6
cd esp-idf-v5.2.6/

This is the recommended way of obtaining v5.5.1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.2.6.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.2.6/esp-idf-v5.2.6.zip

Major changes …

Documentation for IDF v5.5.1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.5.1/

ESP-IDF v5.5.1 is a bugfix release for ESP-IDF v5.5.

Obtaining v5.5.1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.5.1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5.1
cd esp-idf-v5.5.1/

This is the recommended way of obtaining v5.5.1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5.1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.5.1/esp-idf-v5.5.1.zip

Major changes …

Documentation for IDF v5.3.4 is available at https://docs.espressif.com/projects/esp-idf/en/v5.3.4/

ESP-IDF v5.3.4 is a bugfix release for ESP-IDF v5.3.

Obtaining v5.3.4

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.3.4 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.3.4
cd esp-idf-v5.3.4/

This is the recommended way of obtaining v5.3.4 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.3.4.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.3.4/esp-idf-v5.3.4.zip

Major changes …

---

Documentation for IDF v5.5 is available at https://docs.espressif.com/projects/esp-idf/en/v5.5/

ESP-IDF v5.5 is a minor update for ESP-IDF v5.4. Release v5.5 is mostly compatible with apps written for ESP-IDF v5.4.

Obtaining v5.5

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.5 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5
cd esp-idf-v5.5/

This is the recommended way of obtaining v5.5 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history. …

Documentation for IDF v5.5-rc1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.5-rc1/

ESP-IDF v5.5-rc1 is a preview release for ESP-IDF v5.5.

Obtaining v5.5-rc1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.5-rc1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5-rc1
cd esp-idf-v5.5-rc1/

This is the recommended way of obtaining v5.5-rc1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5-rc1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.5-rc1/esp-idf-v5.5-rc1.zip …

Documentation for IDF v5.4.2 is available at https://docs.espressif.com/projects/esp-idf/en/v5.4.2/

ESP-IDF v5.4.2 is a bugfix release for ESP-IDF v5.4.

Obtaining v5.4.2

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.4.2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.4.2
cd esp-idf-v5.4.2/

This is the recommended way of obtaining v5.4.2 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.4.2.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.4.2/esp-idf-v5.4.2.zip

Major changes …

Documentation for IDF v5.5-beta1 is available at https://docs.espressif.com/projects/esp-idf/en/v5.5-beta1/

ESP-IDF v5.5-beta1 is a preview release for ESP-IDF v5.5.

Obtaining v5.5-beta1

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.5-beta1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5-beta1
cd esp-idf-v5.5-beta1/

This is the recommended way of obtaining v5.5-beta1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5-beta1.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history. …

Documentation for IDF v5.0.9 is available at https://docs.espressif.com/projects/esp-idf/en/v5.0.9/

ESP-IDF v5.0.9 is a bugfix update for ESP-IDF v5.0 and also the last bug fix release of ESP-IDF v5.0. According to ESP-IDF Support Period Policy, ESP-IDF v5.0 release branch reached end-of-life in May 2025. With EOL, new features, bug fixes, and security fixes will no longer be supported on this branch. Customers who are currently using ESP-IDF v5.0 release branch are encouraged to upgrade their projects to more recent ESP-IDF releases, such as ESP-IDF v5.3.x.

Obtaining v5.0.9

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.0.9 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.0.9
cd esp-idf-v5.0.9/

This is the recommended way of obtaining v5.0.9 of ESP-IDF.

Download an archive with submodules included …

Documentation for IDF v5.3.3 is available at https://docs.espressif.com/projects/esp-idf/en/v5.3.3/

ESP-IDF v5.3.3 is a bugfix update for ESP-IDF v5.3.

Obtaining v5.3.3

For full installation instructions, see the ESP-IDF Programming Guide.

The source files attached to this release will not work due to our use of git submodules. Use one of the following methods instead:

Using git

To get this release, use the following commands:

git clone -b v5.3.3 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.3.3
cd esp-idf-v5.3.3/

This is the recommended way of obtaining v5.3.3 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v5.3.3.zip archive. It includes .git directory and all the submodules, so can be used out of the box. This archive is provided for users who have connectivity issues preventing them from cloning from GitHub. To reduce the size of the archive, the .git directory doesn't include the history of commits older than one year. Users who need to use git checkout to access an older release of IDF will have to use git fetch first to download the remaining part of the history.

This archive can also be downloaded from Espressif's download server: https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v5.3.3/esp-idf-v5.3.3.zip

Major changes …