| layout | page |
|---|---|
| title | Install |
| permalink | /install |
You're going to need the following items:
You can either proceed with the automatic firmware installation via your webbrowser below or refer to the manual installation instructions.
Just press the install button below with your device connected via usb:
{% include install.html %}
If the serial port is not showing up, your computer might be missing the drivers for the USB serial chip used in your ESP device. These drivers work for most ESP devices:
- Download the latest released firmware for your ESP device
- Download one of the following tools to write the firmware to your ESP device:
- esptool.py or ESPHome-Flasher - we're going to use ESPHome-Flasher here (Mac-Users, please take note of this bug first!)
- Connect your ESP device to your computer
- Start ESPHome-Flasher
- Select the appropiate serial port (should be automatically detected)
- Click "View Logs"
- Start flashing via the "Flash ESP" button
After the flash completed successfully, you should see the SSID you're supposed to connect to in the next step on one of the last lines in the Console window:
The ESP32 will launch a captive browser (under it's own SSID) on first normal boot after flashing that will allow you to configure:
- WiFi settings
- MQTT settings
- Room name
- Discovery distance
See the page on configuring Home Assistant
If you're having difficulty getting things set up and work properly, check out the troubleshooting page before you open an issue. It will help you determine what information you need to provide to identify and fix what's gone wrong.