Getting Started


You’re going to need the following items:


1. Install firmware on base station

You can either proceed with the automatic firmware installation via your webbrowser below or refer to the manual installation instructions.

1.1 Automatic installation via Browser

Just press the install button below with your device connected via usb:

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:

1.2 Manual installation

  • Download the latest released firmware for your ESP device
  • Download one of the following tools to write the firmware to your ESP device:
  • 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:

2. Wifi/MQTT setup on base station

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

3. Configure Home Assistant

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.