Skip to content

MoonLight Installer

Flashing the firmware is easy and doesn't require you to install any development tools. You can do this through a compatible browser which supports webserial like Chrome.

Release 0.6.0, 7 November 2025

This installer installs MoonModules/MoonLight on an ESP32 microcontroller.

See MoonLight Hardware for more info

For a step-by-step instruction, go to MoonLight installation

Installer

  • Plug in your ESP32 Microcontroller to an USB port and wait for the USB port to enumerate, use an USB cable which supports data transfer
  • Choose your board and press Connect and follow the steps, select the correct COM port (USB JTAG/serial debug unit).
  • Most recommended boards are listed first. If your board isn't listed here, try 'others'
  • Some boards: Place the board in bootloader mode by press and holding the Boot button on the ESP32, press the Reset button on the ESP32 and then release the Boot button.
  • After the installation has completed press the Reset button on the ESP32 once again.
Name Image Flash Shop USB Driver
esp32-s3-atoms3r - 🆕 ! esp32-s3-atoms3r M5Stack store
esp32-s3-devkitc-1-n8r8v esp32-s3-devkitc-1-n8r8v
esp32-s3-devkitc-1-n16r8v esp32-s3-devkitc-1-n16r8v Ali*
esp32-s3-stephanelec-16p esp32-s3-stephanelec-16p
esp32-s3-zero-n4r2 esp32-s3-zero-n4r2 Ali*
esp32-d0-wrover esp32-d0-wrover Ali*
esp32-d0-wrover-moonbase esp32-d0-wrover Ali*
esp32-d0-16mb esp32-d0-16mb Serg74
esp32-d0 esp32-d0
esp32-d0-moonbase esp32-d0
esp32-p4-nano esp32-p4-nano Waveshare
esp32-p4-olimex 🚧 esp32-p4-olimex Olimex
esp32-c3-devkitm-1 esp32-c3-devkitm-1 Ali*
esp32-c3-supermini esp32-c3-supermini Ali*
others others
  • MoonBase firmware is MoonBase only, no MoonLight included (basis for other IOT projects)

USB-to-serial chip drivers

In case your computer does not recognise your connected ESP32, you might need to install the right USB-to-serial chip drivers. Below are the drivers for common chips used in ESP devices. See the images below to see what chip your ESP32 has.

  • CP210x drivers: Windows & Mac
  • CH342, CH343, CH9102 drivers: Windows, Mac (download via blue button with download icon)
  • CH340, CH341 drivers: Windows, Mac (download via blue button with download icon)

Powered by ESP Web Tools

See also ESP-Web-Tools-Tutorial

*: Affiliate link