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! This is the ESPHome setup wizard. It 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, the wizard will save a configuration file under <HASS_CONFIG_FOLDER>/esphome/<NAME_OF_NODE>.yaml.

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. For newly plugged in serial devices to be detected, restart the add-on.
- With the current configuration, your node will only connect to WiFi. 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! Discord's the best place to ask if you have issues/ideas.
- Star ESPHome on GitHub if you find this software awesome and report issues using the bug trackers there.

{% if len(entries) == 0 %}

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 🎉

{% end %}

Show Logs

Compile And Upload

Compile

Validate

Next steps

Clean MQTT discovery

Clean Build Files

Edit

Set up your first Node