ESPHome Dashboard

{% for i, entry in enumerate(entries) %}

. Full path: {{ escape(entry.full_path) }}

{% if entry.update_available %}

Update Available! {{ entry.update_old }} ➡️{{ entry.update_new }}

{% end %}

Upload Edit Show Logs Validate

{% end %}

Introduction And Name

Hi there! I'm the ESPHome setup wizard and will guide you through setting up your first ESP8266 or ESP32-powered device using ESPHome.
ESP8266s and their successors (the ESP32s) are great low-cost microcontrollers that can communicate with the outside world using WiFi. They're found in many devices such as the popular Sonoff/iTead, but also exist as development boards such as the NodeMCU.

ESPHome, the tool you're using here, creates custom firmwares for these devices using YAML configuration files (similar to the ones you might be used to with Home Assistant).

This wizard will create a basic YAML configuration file for your "node" (the microcontroller). Later, you will be able to customize this file and add some of ESPHome's many integrations.

First, I need to know what this node should be called. Choose this name wisely, it should be unique among all your ESPs. Names must be lowercase and must not contain spaces (allowed characters: a-z, 0-9 and _)

Name of node
Device Type

Great! Now I need to know what type of microcontroller you're using so that I can compile firmware for them. Please choose the board you're using below. If you're not sure you can also use similar ones or even the "Generic" option. In most cases that will work too.
WiFi And Over-The-Air Updates

Thanks! Now I need to know what WiFi Access Point I should instruct the node to connect to. Please enter an SSID (name of the WiFi network) and password (leave empty for no password).

WiFi SSID

WiFi Password

ESPHome automatically sets up an Over-The-Air update server on the node so that you only need to flash a firmware via USB once. This password is also used to connect to the ESP from Home Assistant. Optionally, you can set a password for this upload process here:

Access Password
Done!
Hooray! 🎉🎉🎉 You've successfully created your first ESPHome configuration file. When you click Submit, I will save this configuration file under <HASS_CONFIG_FOLDER>/esphomeyaml/<NAME_OF_NODE>.yaml and you will be able to edit this file with the HASS Configuratior add-on.

Next steps
- Flash the firmware. This can be done using the “UPLOAD” option in the dashboard. See this for guides on how to flash different types of devices. Note that you need to restart this add-on for newly plugged in serial devices to be detected.
- With the current configuration, your node will only connect to WiFi and MQTT. To make it actually do stuff, follow the rest of the getting started guide .
- See the ESPHome index for a list of supported sensors/devices.
- Join the Discord server and say hi! When I have time, I would be happy to help with issues and discuss new features.
- Star ESPHome Core and ESPHome on GitHub if you find this software awesome and report issues using the bug trackers there.

Set up your first Node

Huh... It seems like you you don't have any ESPHome configuration files yet... Fortunately, there's a setup wizard that will step you through setting up your first node 🎉

Show Logs

Compile And Upload

Compile

Validate

Next steps

Clean MQTT discovery

Clean Build Files

Generate Home Assistant Configuration

Edit

Set up your first Node