Espressif Release Notes

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

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

Obtaining v5.3.6

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

Using EIM

The recommended way to obtain and install ESP-IDF v5.3.6 is through the ESP-IDF Installation Manager (EIM). EIM supports obtaining ESP-IDF releases from Espressif mirrors as well as directly from Git repositories.

eim install -i v5.3.6

Using git

To download this release using git, use the following command:

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

To install ESP-IDF build tools, use EIM:

eim install -p esp-idf-v5.3.6

or the legacy installation method.

Download an archive with submodules included …

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

ESP-IDF v5.2.8 is a bugfix update for ESP-IDF v5.2 and also the last bug fix release of ESP-IDF v5.2. According to ESP-IDF Support Period Policy, ESP-IDF v5.2 release branch reached end-of-life in August 2026. 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.2 release branch are encouraged to upgrade their projects to more recent ESP-IDF releases, such as ESP-IDF v6.0.3.

Obtaining v5.2.8

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

Using EIM

The recommended way to obtain and install ESP-IDF v5.2.8 is through the ESP-IDF Installation Manager (EIM). EIM supports obtaining ESP-IDF releases from Espressif mirrors as well as directly from Git repositories.

eim install -i v5.2.8

Using git

To download this release using git, use the following command:

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

To install ESP-IDF build tools, use EIM:

eim install -p esp-idf-v5.2.8
``` …

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

ESP-IDF v6.0.3 is a bugfix release for ESP-IDF v6.0.

Obtaining v6.0.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 v6.0.3 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0.3
cd esp-idf-v6.0.3/

This is the recommended way of obtaining v6.0.3 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v6.0.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/v6.0.3/esp-idf-v6.0.3.zip

Major changes …

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

ESP-IDF v6.1 is a minor update for ESP-IDF v6.0. Release v6.1 is mostly compatible with apps written for ESP-IDF v6.0.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v6.0 to v6.1 release.

Obtaining v6.1

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

Using EIM

The recommended way to obtain and install ESP-IDF v6.1 is through the ESP-IDF Installation Manager (EIM). EIM supports obtaining ESP-IDF releases from Espressif mirrors as well as directly from Git repositories.

eim install -i v6.1

Using git

To download this release using git, use the following command:

git clone -b v6.1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.1

To install ESP-IDF build tools, use EIM:

eim install -p esp-idf-v6.1

or the legacy installation method.

Download an archive with submodules included …

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

ESP-IDF v6.1-rc1 is a minor update for ESP-IDF v6.0. Release v6.1 is mostly compatible with apps written for ESP-IDF v6.0. Release v6.0.2 is the latest stable release at the time of writing.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v6.0 to v6.1 release.

Obtaining v6.1-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 v6.1-rc1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.1-rc1
cd esp-idf-v6.1-rc1/

This is the recommended way of obtaining v6.1-rc1 of ESP-IDF.

Download an archive with submodules included …

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

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

Obtaining v5.5.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.5 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5.5
cd esp-idf-v5.5.5/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5.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.

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

Major changes …

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

ESP-IDF v6.1-beta1 is a minor update for ESP-IDF v6.0. Release v6.1 is mostly compatible with apps written for ESP-IDF v6.0. Release v6.0.2 is the latest stable release at the time of writing.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v6.0 to v6.1 release.

Obtaining v6.1-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 v6.1-beta1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.1-beta1
cd esp-idf-v6.1-beta1/

This is the recommended way of obtaining v6.1-beta1 of ESP-IDF.

Download an archive with submodules included …

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

ESP-IDF v6.0.2 is a bugfix release for ESP-IDF v6.0.

Obtaining v6.0.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 v6.0.2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0.2
cd esp-idf-v6.0.2/

This is the recommended way of obtaining v6.0.2 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v6.0.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/v6.0.2/esp-idf-v6.0.2.zip

Changelog …

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

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

Obtaining v5.2.7

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.7 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.2.7
cd esp-idf-v5.2.7/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.2.7.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.7/esp-idf-v5.2.7.zip

Major changes …

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

ESP-IDF v6.0.1 is a bugfix release for ESP-IDF v6.0.

Obtaining v6.0.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 v6.0.1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0.1
cd esp-idf-v6.0.1/

This is the recommended way of obtaining v6.0.1 of ESP-IDF.

Download an archive with submodules included

Attached to this release is an esp-idf-v6.0.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/v6.0.1/esp-idf-v6.0.1.zip

Changelog …

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

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

Obtaining v5.4.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.4.4 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.4.4
cd esp-idf-v5.4.4/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.4.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.4.4/esp-idf-v5.4.4.zip

Changelog …

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

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

Obtaining v5.5.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.5.4 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5.4
cd esp-idf-v5.5.4/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5.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.5.4/esp-idf-v5.5.4.zip

Major changes …

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

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

Obtaining v5.3.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.3.5 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.3.5
cd esp-idf-v5.3.5/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.3.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.

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

Major changes …

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

ESP-IDF v6.0 is a major update for ESP-IDF v5.x. Release v6.0 is mostly compatible with apps written for ESP-IDF v5.x, but there are some breaking changes (please consult the list below) and removal of deprecated functionality which will require code changes when updating projects.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v5.x to v6.0 release. Note that from v6.0 (final release) onward, and for all future IDF releases, the full changelog of release notes will be published on the ESP Release Notes site.

Obtaining v6.0

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 v6.0 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0
cd esp-idf-v6.0/

This is the recommended way of obtaining v6.0 of ESP-IDF.

Download an archive with submodules included …

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

ESP-IDF v6.0-rc1 is a major update for ESP-IDF v5.x. Release v6.0 is mostly compatible with apps written for ESP-IDF v5.x, but there are some breaking changes (please consult the list below) and removal of deprecated functionality which will require code changes when updating projects. Release v5.5.3 is the latest stable release at the time of writing.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v5.x to v6.0 release. Note that from v6.0 (final release) onward, and for all future IDF releases, the full changelog of release notes will be published on the ESP Release Notes site.

Obtaining v6.0-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 v6.0-rc1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0-rc1
cd esp-idf-v6.0-rc1/

This is the recommended way of obtaining v6.0-rc1 of ESP-IDF. …

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

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

Obtaining v5.5.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.5.3 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5.3
cd esp-idf-v5.5.3/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5.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.5.3/esp-idf-v5.5.3.zip

Major changes …

Documentation for IDF v6.0-beta2 is available at https://docs.espressif.com/projects/esp-idf/en/v6.0-beta2/

ESP-IDF v6.0-beta2 is a major update for ESP-IDF v5.x. Release v6.0 is mostly compatible with apps written for ESP-IDF v5.x, but there are some breaking changes (please consult the list below) and removal of deprecated functionality which will require code changes when updating projects. Release v5.5.2 is the latest stable release at the time of writing.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v5.x to v6.0 release.

Obtaining v6.0-beta2

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 v6.0-beta2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0-beta2
cd esp-idf-v6.0-beta2/

This is the recommended way of obtaining v6.0-beta2 of ESP-IDF.

Download an archive with submodules included …

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

ESP-IDF v5.1.7 is a bugfix update for ESP-IDF v5.1 and also the last bug fix release of ESP-IDF v5.1. According to ESP-IDF Support Period Policy, ESP-IDF v5.1 release branch reached end-of-life in December 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.1 release branch are encouraged to upgrade their projects to more recent ESP-IDF releases, such as ESP-IDF v5.5.x.

Obtaining v5.1.7

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.1.7 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.1.7
cd esp-idf-v5.1.7/

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

Download an archive with submodules included …

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

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

🎅 Obtaining v5.5.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.5.2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5.2
cd esp-idf-v5.5.2/

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

Download an archive with submodules included

Attached to this release is an esp-idf-v5.5.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.5.2/esp-idf-v5.5.2.zip

Major changes …

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

ESP-IDF v6.0-beta1 is a major update for ESP-IDF v5.x. Release v6.0 is mostly compatible with apps written for ESP-IDF v5.x, but there are some breaking changes (please consult the list below) and removal of deprecated functionality which will require code changes when updating projects. Release v5.5.1 is the latest stable release at the time of writing.

We highly recommend referring to our migration guide while moving your apps from ESP-IDF v5.x to v6.0 release.

Obtaining v6.0-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 v6.0-beta1 --recursive https://github.com/espressif/esp-idf.git esp-idf-v6.0-beta1
cd esp-idf-v6.0-beta1/

This is the recommended way of obtaining v6.0-beta1 of ESP-IDF.

Download an archive with submodules included …