ESP32 with Arduino IDE: Complete Beginner Guide

What you will do

This guide is for the moment when you have an ESP32 board and want Arduino IDE to upload code to it. By the end, your computer should recognize the board, Arduino IDE should know about ESP32 boards, and your first sketch should print a message in Serial Monitor.

The path is simple: install Arduino IDE, add ESP32 support, select the right board and port, upload a first sketch, verify output, then move to hardware missions such as Blink an LED with ESP32.

What you need before starting

• ESP32 development board: a common ESP32 DevKit or ESP32-WROOM board with USB.
• USB data cable: many charging cables power the board but cannot upload code.
• Computer: Windows, macOS, or Linux with permission to install software.
• Arduino IDE 2.x: the current beginner-friendly Arduino editor.
• Internet access: needed once to download the ESP32 board package.

If you are still choosing a board, read the ESP32 DevKit component guide first. It explains USB, pins, power, and why ESP32 GPIO is 3.3 V.

What Arduino IDE does for ESP32

Arduino IDE is the program where you write sketches. A sketch is a small C++ program with two important functions: setup(), which runs once, and loop(), which repeats.

Arduino IDE does not support ESP32 by default. You add the official Espressif board package so the IDE knows which compiler, upload tool, board menu, and ESP32 core libraries to use. After that, uploading to ESP32 feels similar to uploading to a classic Arduino board, but the voltage, pin behavior, and board selection are ESP32-specific.

1. Install Arduino IDE

1. Go to the official Arduino website and download Arduino IDE 2.x for your operating system.
2. Install it with the default options unless your school or company has a managed installer.
3. Open Arduino IDE once so it creates its sketchbook and settings folders.

Use the official Arduino download. Avoid random installer mirrors because the IDE will later download compiler tools and board support packages.

2. Connect your ESP32 correctly

1. Plug the ESP32 into your computer with a known USB data cable.
2. Watch for a power LED on the board. A power LED only confirms power, not data.
3. Do not attach sensors, relays, motors, or breadboard wiring for the first upload. Start with the bare board.

You should now see a serial port such as COM3 or COM5 on Windows, /dev/cu.usbserial-* on macOS, or /dev/ttyUSB0 on Linux. The exact name varies by computer.

3. Add ESP32 support to Arduino IDE

1. Open File > Preferences.
2. Find Additional boards manager URLs.
3. Paste this official Espressif package URL:

https://espressif.github.io/arduino-esp32/package_esp32_index.json

If the field already has another URL, add the ESP32 URL on a new line using the list editor, or separate URLs as Arduino IDE allows. Click OK when finished.

4. Install the ESP32 board package

1. Open Tools > Board > Boards Manager.
2. Search for esp32.
3. Install esp32 by Espressif Systems.
4. Wait for the download and tool installation to finish.

This package includes the ESP32 Arduino core, compiler tools, libraries, and upload utility. If this step fails, check your internet connection and make sure the board manager URL was entered exactly.

5. Select your ESP32 board

Open Tools > Board > esp32. For many generic ESP32-WROOM DevKit boards, choose ESP32 Dev Module. If your exact board appears in the list, such as an ESP32-S3 or ESP32-C3 board, choose the matching entry.

6. Select the correct port

1. Open Tools > Port.
2. Unplug the ESP32 and notice which port disappears.
3. Plug it back in and select the port that reappears.

On Windows, the port usually looks like COM3 or COM5. On macOS, it often starts with /dev/cu.. On Linux, it often starts with /dev/ttyUSB or /dev/ttyACM.

If no port appears, skip ahead to the troubleshooting table. Most port problems are cable or USB-driver problems, not code problems.

7. Upload your first ESP32 sketch

For the first upload, use Serial output instead of an LED. That avoids assuming your board has an onboard LED on a particular GPIO.

void setup() {
    Serial.begin(115200);
    delay(1000);
    Serial.println("ESP32 is running from Arduino IDE!");
  }

  void loop() {
    Serial.println("Hello from ESP32");
    delay(1000);
  }

1. Copy the sketch into Arduino IDE.
2. Click Verify to compile it.
3. Click Upload.
4. Wait for the upload to finish and the board to reset.

A successful upload usually ends with a message similar to Hard resetting via RTS pin. The wording can vary by board and Arduino core version.

8. Open Serial Monitor

1. Open Tools > Serial Monitor.
2. Set the baud rate to 115200.
3. Press the board's EN or RESET button if the first line does not appear.

You should now see ESP32 is running from Arduino IDE!, followed by Hello from ESP32 once per second. That proves the board package, board selection, port selection, upload process, and serial monitor are all working together.

9. Understand the basic sketch

Later projects replace the Serial message with GPIO output, button input, sensor readings, OLED display updates, Wi-Fi requests, and MQTT messages.

10. Optional next check: blink an LED

If your board has a documented user LED, you can blink it after Serial output works. Do not assume every ESP32 board uses GPIO2. Some boards use a different GPIO, and some have no user LED.

For a reliable beginner hardware check, follow the dedicated Blink an LED with ESP32 mission. It uses an external LED, a resistor, and a clear wiring diagram, so the result does not depend on a board-specific onboard LED.

Common ESP32 Arduino IDE problems

BOOT and EN buttons explained

Many ESP32 DevKit boards have two buttons. EN or RESET restarts the chip. BOOT can force the chip into serial bootloader mode so the upload tool can write new firmware.

Modern boards often handle this automatically. If upload fails at the connecting step, hold BOOT, click Upload, wait until Arduino IDE starts connecting, then release BOOT. You should not need BOOT after every upload once the board and cable are working reliably.

What to learn next

Once Serial output works, follow a build-first path. Each step uses a real existing ESP32 Engine page:

1. Understand ESP32 basics so 3.3 V GPIO and board families make sense.
2. Blink an LED to control a GPIO output safely.
3. Control an LED with a button to read digital input.
4. Learn floating pins, then pull-up and pull-down resistors.
5. Read analog inputs and understand ADC limits.
6. Read a DHT22 temperature sensor or explore BME280 for weather data.
7. Show values on an OLED display.
8. Build a complete project such as the ESP32 IoT Weather Station, ESP32 Smart Thermostat, or ESP32 Line Following Robot.

Quick checklist before every upload

• Correct board selected in Tools > Board.
• Correct port selected in Tools > Port.
• USB cable supports data.
• Serial Monitor is closed during upload.
• No external circuit is pulling BOOT strapping pins into the wrong state.
• Serial Monitor baud rate matches the sketch after upload.