ESPHome in Home Assistant
esphome
part of Home Assistant since 0.85
ESPHome connects Home Assistant with devices running ESPHome firmware, enabling DIY home automation projects. It supports a wide range of sensors, actuators, and custom hardware for smart home integration and automation.
Typical uses
- home automation
- custom sensors
- smart home devices
- automation with ESP-based hardware
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Local, push – Talks to the device on your own network and is told about every change straight away.
- Setup
- in the user interface
- Kind
- Single device
- Quality scale
- Platinum – The highest level: fully typed, efficient and maintained to every rule of the project.
- Installations
- 155,106 (21.6 % of the installations that share statistics)
- Provides
- Alarm control panel, Voice satellite, Binary sensor, Button, Camera, Climate, Cover, Date, Date and time, Diagnostics, Event, Fan, Light, Lock, Media player, Number, Select, Sensor, Switch, Text, Time, Update, Valve, Water heater
- Found automatically via
- Network discovery (Zeroconf), Network discovery (DHCP), MQTT
- Maintained by
- @jesserockz, @kbx81, @bdraco, @arturpragacz
- Python packages
aioesphomeapi==46.21.0, esphome-dashboard-api==1.4.0, bleak-esphome==4.0.0
Setup
- Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for ESPHome.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Matching add-ons
Add-ons that declare a connection to this integration in their own configuration.
Blueprints that use this integration
- Automation NSPanel Configuration – Configures NSPanel devices with ESPhome, using weather and sensor data to trigger light notifications and controls.
- Automation NSPanel Easy Configuration (v2026.10.7) – Configures NSPanel with ESPHome devices using sensors, weather, and light entities to send notifications and adjust settings.
- Automation Automatic door unlock – Unlocks a door when a person enters a zone, using Bermuda and ESPHome integrations with lock and sensor entities.
- Automation Send a camera snapshot when doorbell was activated
- Automation Automatic door unlock – Unlocks doors automatically when a person enters a zone, using lock entities.
- Automation ESPHome Device Update
Known issues and fixes
26 open issues and 43 bug fixes in the last twelve months are recorded for ESPHome in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.10.0.
Open
- open Reported problem #139060
- open Sensor values display excessive decimal places after an upgrade.
- open Devices configured with a hostname occasionally revert to using the IP address instead.
- open Sensor accuracy settings are not respected, leading to imprecise measurements.
- open The dashboard logs unnecessary connection errors when the Device Builder is intentionally stopped.
- open A long press automation triggers unexpectedly when a connection is restored.
- open Incorrect timezone information is sent to devices via the ESPHome API.
- open System logs show misleading errors related to the ESPHome manager.
Fixed
- fixed in 2026.10.0 The preset mode for ESPHome fans was not properly communicated when turning them on.
- fixed in 2026.10.0 The voice audio stream was incorrectly terminated when receiving an empty frame.
- fixed in 2026.10.0 The setup process completed before the assist satellite platform was fully ready.
- fixed in 2026.10.0 The initial state of imported entities was not correctly shared when entities were created late.
- fixed in 2026.10.0 The Z-Wave home ID did not update properly after a home ID change.
- fixed in 2026.9.2 The setup process failed if the Supervisor was not ready, causing unnecessary errors.
- fixed in 2026.9.0 Serial device manufacturer and model information was not correctly derived from the project settings.
- fixed in 2026.8.0 A stale encryption key was incorrectly used instead of the active one during configuration.
- fixed in 2026.8.0 The dashboard adoption process incorrectly blocked access to provisioned devices.
- fixed in 2026.7.2 The global update lock was not bypassed when the dashboard had an active build queue.
- fixed in 2026.6.2 The startup process did not wait for the Bluetooth proxy connection to establish properly.
- fixed in 2026.6.0 The update entity remained stuck for project versions with a build suffix.
Source: the issue tracker of Home Assistant, as of October 25, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Compatible devices
Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.