ESPHome
Home View the repo
ESPHome is a firmware project designed for ESP-based hardware.
auto-summary
12140 stars · 5831 forksGitHub repo · as of 2026-11-21 11:07 UTC
- Maintainer
- esphome
- License
- MIT AND GPL-3.0-only
- Distribution
- web-flasheresp-web-tools
- Capabilities
- wifiethernetblebluetooth-proxymqttotaon-device-web-uidisplay
- Chip families
- esp32esp32-s2esp32-s3esp32-c2esp32-c3esp32-c5esp32-c6esp32-h2esp32-p4
Boards with a recipe, by trust tier
Known good
- ESP32-C5-DevKitC-1Known goodweb flasher
Flash ESP32-C5-DevKitC-1
Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the ESP32-C5-DevKitC-1 is that reference board for `variant: esp32c5`, so any esphome YAML with that variant (or no board override) runs on it unmodified. Verified on real hardware 2026-09-01: ESPHome 2026.8.2 (`framework: esp-idf`, ESP-IDF 5.5.5) compiled for `variant: esp32c5`, flashed as the factory image at 0x0 with esptool 5.3.0 over the USB-to-UART port; boots and logs `ESP32 Chip: ESP32-C5 rev1.2`, and drives the onboard GPIO27 WS2812 through `esp32_rmt_led_strip`. Note: the same chip revision answers CHIP magic 0x30e1706f, which the in-browser flashers (esptool-js 0.6.1) do not recognise -- web.esphome.io could not detect it; the CLI + esptool path works.
- Inkplate 10Known goodweb flasher
Flash Inkplate 10
Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Supported by ESPHome's official Inkplate display component (`inkplate_10` model).
- Inkplate 6Known goodweb flasher
Flash Inkplate 6
Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Supported by ESPHome's official Inkplate display component (`inkplate_6` / `inkplate_6_v2` models).
Reported
- WiFi LoRa 32 (V3)Reportedweb flasher
Flash WiFi LoRa 32 (V3)
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration including the SX1262 LoRa radio, OLED and battery ADC.
- T-Display-S3Reportedweb flasher
Flash T-Display-S3
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration for the non-touch variant (ST7789 display).
- T-Dongle-S3Reportedweb flasher
Flash T-Dongle-S3
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration for the ST7735 display, button and SPI LED.
- AtomS3-LiteReportedweb flasher
Flash AtomS3-Lite
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration for the RGB LED, button and IR transmitter.
- DialReportedweb flasher
Flash Dial
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration covering the display, touch, rotary encoder, NFC reader and buzzer.
- NanoC6Reportedweb flasher
Flash NanoC6
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration for Wi-Fi, the LEDs, button and IR transmitter.
- Core2Reportedweb flasher
Flash Core2
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration covering the AXP192 power management, display, touchscreen, IMU and RTC; the entry notes the speaker does not work.
- CoreS3Reportedweb flasher
Flash CoreS3
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration covering the display, touch, AXP2101 PMU and IO expander.
- StickC-Plus2Reportedweb flasher
Flash StickC-Plus2
Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: Community-contributed configuration covering the display, IMU, buttons, buzzer, microphone and battery monitoring.
Unverified
- ESP32-C6-DevKitC-1Unverifiedweb flasher
Flash ESP32-C6-DevKitC-1
Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the Espressif ESP32-C6-DevKitC-1 is that reference board for `variant: esp32c6`, so any esphome YAML with that variant (or no board override) runs on it unmodified.
- ESP32-DevKitC V4Unverifiedweb flasher
Flash ESP32-DevKitC V4
Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the Espressif ESP32-DevKitC-V4 is that reference board for plain esp32, so any esphome YAML with `variant: esp32` (or no board override) runs on it unmodified.
- ESP32-S3-DevKitC-1Unverifiedweb flasher
Flash ESP32-S3-DevKitC-1
Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.
Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the Espressif ESP32-S3-DevKitC-1 is that reference board for `variant: esp32s3`, so any esphome YAML with that variant (or no board override) runs on it unmodified.