ESPHome — ESPHome

Getting StartedFrom Home Assistant Using Command Line Ready-Made Projects Migrate from Tasmota FAQ and TipsNext StepsDocumentation Automations Configuration Types Device Examples DIY Examples Sharing ESPHome Devices Made for ESPHomeKeeping UpChangelog Discord Forums Development SupportersSmart Home Made Simple

Turn your ESP32, ESP8266, or RP2040 boards into powerful smart home devices with simple YAML configuration

Installation Guide Browse Components Device Database

What is ESPHome?

ESPHome is an open-source firmware framework that simplifies the process of creating custom firmware for popular WiFi-enabled microcontrollers. With ESPHome, you can:

• Create custom smart home devices using simple YAML configuration files
• Integrate seamlessly with Home Assistant for a unified smart home experience
• Control and monitor your devices through multiple interfaces (web, API, MQTT)
• Automate your home with powerful on-device automations
• Update your devices wirelessly “Over The Air” (OTA) updates without physical access

ESPHome takes care of the complex parts of firmware development, allowing you to focus on what matters - building your smart home exactly how you want it.

No Coding Required

Simple YAML configuration files instead of complex C++ code

Wireless Updates

Update your devices over-the-air without physical access

Modular Design

Support for hundreds of sensors, displays, and other components

Local Control

Devices work locally without cloud dependencies

Who Uses ESPHome?

DIY Enthusiasts

Create custom sensors, switches, and displays tailored to specific needs

Smart Home Hobbyists

Extend their home automation systems with affordable custom devices

Professional Integrators

Deploy reliable, locally-controlled smart devices for clients

Manufacturers

Create Made for ESPHome certified products with standardized firmware

Which microcontrollers does ESPHome support?

Espressif ESP32 and ESP8266

Wide support for ESP32 and ESP8266 microcontrollers, the heart of many IoT projects.

RP2040

Support for Raspberry Pi’s RP2040 microcontroller.

Others

Nordic Semiconductor nRF52, Realtek RTL87xx, and Beken BK72xx chips are supported.

Desktop

Many ESPHome components can be run on a desktop computer using the host platform!

Getting Started

Getting started with ESPHome is easy. Choose the method that works best for you:

From Home Assistant

The easiest way to get started with ESPHome is through the Home Assistant add-on.

Home Assistant GuideCommand Line

For advanced users who prefer working with the command line.

Command Line GuideReady-Made Projects

Start with a pre-configured project for common use cases.

Browse ProjectsESPHome is a project from the https://esphome.io