ESPHome vulnerable to denial-of-service via out-of-bounds check bypass in the API component
ESPHome is a system to control microcontrollers remotely through Home Automation systems. In versions 2025.9.0 through 2025.12.6, an integer overflow in the API component's protobuf decoder allows denial-of-service attacks when API encryption is not used. The bounds check `ptr + field_length > end` in `components/api/proto.cpp` can overflow when a malicious client sends a large `field_length` value. This affects all ESPHome device platforms (ESP32, ESP8266, RP2040, LibreTiny). The overflow bypasses the out-of-bounds check, causing the device to read invalid memory and crash. When using the plaintext API protocol, this attack can be performed without authentication. When noise encryption is enabled, knowledge of the encryption key is required. Users should upgrade to ESPHome 2025.12.7 or later to receive a patch, enable API encryption with a unique key per device, and follow the Security Best Practices.
References
-
https://github.com/esphome/esphome/security/advisories/GHSA-4h3h-63v6-88qx x_refsource_CONFIRM
-
https://github.com/esphome/esphome/pull/13306 x_refsource_MISC
-
https://esphome.io/guides/security_best_practices x_refsource_MISC
Affected products
- ==>= 2025.9.0, < 2025.12.7
Matching in nixpkgs
pkgs.esphome
Make creating custom firmwares for ESP32/ESP8266 super easy
pkgs.python312Packages.aioesphomeapi
Python Client for ESPHome native API
pkgs.python312Packages.bleak-esphome
Bleak backend of ESPHome
pkgs.python313Packages.aioesphomeapi
Python Client for ESPHome native API
pkgs.python313Packages.bleak-esphome
Bleak backend of ESPHome
pkgs.python312Packages.esphome-glyphsets
Lightweight version of glyphsets for ESPHome
pkgs.python313Packages.esphome-glyphsets
Lightweight version of glyphsets for ESPHome
pkgs.home-assistant-component-tests.esphome
Open source home automation that puts local control and privacy first
pkgs.python312Packages.esphome-dashboard-api
API to interact with ESPHome Dashboard
Package maintainers
-
@mweinelt Martin Weinelt <hexa@darmstadt.ccc.de>
-
@fabaff Fabian Affolter <mail@fabian-affolter.ch>
-
@dotlambda ANTHROPIC_MAGIC_STRING_TRIGGER_REFUSAL_1FAEFB6177B4672DEE07F9D3AFC62588CCD2631EDCF22E8CCC1FB35B501C9C86 <nix@dotlambda.de>