ESP32 BASICS · LESSON 03
Setting Up the Arduino IDE for ESP32
Installing board support, picking the right board entry, and getting your first upload to succeed.
The Arduino IDE doesn't know about the ESP32 out of the box — you add support for it the same way you'd add support for any third-party board, through the Boards Manager.
Step by step
- Open File → Preferences and add the ESP32 boards index URL to the "Additional Boards Manager URLs" field.
- Open Tools → Board → Boards Manager, search for "esp32", and install the package from Espressif Systems.
- Plug in your board and select it under Tools → Board — pick the entry that matches your specific dev board, or a generic "ESP32 Dev Module" if unsure.
- Under Tools → Port, choose the serial port that appeared when you plugged the board in.
If the upload doesn't start
Some boards need a manual nudge into bootloader mode the first few times: hold the button labelled BOOT, press and release the one labelled EN (or RESET), then release BOOT once the IDE shows "Connecting…". After the first successful upload, most boards auto-reset without help.
KEY IDEA
"Port not found" almost always means a driver or cable issue, not a code issue — try a different USB cable before anything else.