ESPHome

Version2026.10.2

Source codePublic

Compatible withumbrelOS 0.5 or later

ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configuration files and control them remotely through Home Automation systems.

What's new

Version 2026.10.2+Nov 3, 2026

⚠️ Review the upstream upgrade checklist before updating device firmware. ESP8266 now uses the native Arduino toolchain and the first compile is a clean build; set toolchain: platformio under esp8266: temporarily if your board or custom framework needs the old toolchain. Sendspin requires Music Assistant 2.10.7 or newer (or 2.11.0b4 or newer).

Check existing light boot-state settings, speaker codec and mute automations, remote-receiver buffer sizes, Climate IR modes, USB UART filters, e-paper settings, and custom lambdas or external components for breaking changes described upstream.

This update fixes TLS 1.3 support for ESP32 audio streaming and releases Bluetooth proxy connections when a new client takes over. It also prevents corrupted compressed OTA updates on RTL8710B devices and adds downloads for native host programs in the Device Builder.

Upgrade checklist: https://esphome.io/blog/2026/10/21/esphome-2026-10/

Full release notes can be found at https://github.com/esphome/esphome/releases/tag/2026.10.2

Version 2026.10.1+Oct 28, 2026

⚠️ Review the upstream upgrade checklist before updating device firmware. ESP8266 now uses the native Arduino toolchain and the first compile is a clean build; set toolchain: platformio under esp8266: temporarily if your board or custom framework needs the old toolchain. Sendspin requires Music Assistant 2.10.7 or newer (or 2.11.0b4 or newer).

Check existing light boot-state settings, speaker codec and mute automations, remote-receiver buffer sizes, Climate IR modes, USB UART filters, e-paper settings, and custom lambdas or external components for breaking changes described upstream.

This update fixes firmware compilation with custom includes, version-less library dependencies, and infinite numeric values. It also improves MQTT fan-state retries, ESP32 coprocessor OTA reliability, and compatibility for light effects and climate automations.

Upgrade checklist: https://esphome.io/blog/2026/10/21/esphome-2026-10/

Full release notes can be found at https://github.com/esphome/esphome/releases/tag/2026.10.1

Version 2026.10.0+Oct 21, 2026

⚠️ Review the upstream upgrade checklist before updating device firmware. ESP8266 now uses the native Arduino toolchain and the first compile is a clean build; set toolchain: platformio under esp8266: temporarily if your board or custom framework needs the old toolchain. Sendspin requires Music Assistant 2.10.7 or newer (or 2.11.0b4 or newer).

Check existing light boot-state settings, speaker codec and mute automations, remote-receiver buffer sizes, Climate IR modes, USB UART filters, e-paper settings, and custom lambdas or external components for breaking changes described upstream.

This release adds compressed OTA uploads on more platforms, faster firmware builds, lower memory usage, native API outgoing connections, and new sensor, audio, USB bridge, and touchscreen components.

Full release notes can be found at https://esphome.io/blog/2026/10/21/esphome-2026-10/

Version 2026.9.1+Sep 30, 2026

ESPHome 2026.9.1 fixes OTA encryption-key handling for safe-mode uploads without the API server, masks password text-entity values more consistently in the web server, and includes stability fixes for MIPI displays, LVGL build flags, ESP32/RP2040 crash logging, ESP32-P4 builds, SPI Ethernet, and mixer task handling.

Review the upstream 2026.9 breaking changes before updating if your configs use Modbus Controller custom_command, register_count, force_new_range, or skip_updates; ESP32 custom eFuse MACs with Ethernet, Bluetooth, Thread, or Zigbee; custom lambdas or external components; or components with unsupported non-default UART settings such as mhz19, daly_bms, or teleinfo.

Full release notes can be found at https://github.com/esphome/esphome/releases/tag/2026.9.1

Version 2026.9.0+Sep 17, 2026

ESPHome 2026.9.0 is a major monthly update with faster parallel build-tool setup, ESP8266 native-toolchain groundwork and RAM savings, Noise-encrypted OTA updates, six new components, and expanded LVGL, Modbus, Tuya, networking, and sensor support.

Review the upstream breaking changes before updating if your configs use Modbus Controller custom_command, register_count, force_new_range, or skip_updates; ESP32 custom eFuse MACs with Ethernet, Bluetooth, Thread, or Zigbee; custom lambdas or external components; or components with unsupported non-default UART settings such as mhz19, daly_bms, or teleinfo.

Full release notes can be found at https://github.com/esphome/esphome/releases/tag/2026.9.0

Related