Installing ESP8266 NodeMCU Board in Arduino IDE 2.0 (Windows, Mac OS X, Linux)

There is a new Arduino IDE—Arduino IDE 2.0 (beta version). In this tutorial, you’ll learn how to install the ESP8266 boards in Arduino IDE 2.0 and upload code to the board. This tutorial is compatible with Windows, Mac OS X, and Linux operating systems.

Installing Programming ESP8266 NodeMCU Board in Arduino 2.0 Windows Mac OS X Linux

Arduino IDE 2.0 is an experimental software—it is still in beta version. This means that you may find some bugs and some features may not be fully developed.

If you want to install the ESP8266 boards on the “classic” Arduino IDE, follow the next tutorial instead:

If you prefer programming the ESP8266 using VS Code + PlatformIO, go to the following tutorial:

You migh also like reading the ESP32 Guide: Installing ESP32 Board in Arduino IDE 2.0 (Windows, Mac OS X, Linux)

Prerequisites: Arduino IDE 2.0 Installed

Before proceeding make sure you have Arduino IDE 2.0 installed in your computer.

Go to the Arduino website and download the version for your operating system.

Arduino 2.0 Downloads Page downloading
  • Windows: run the file downloaded and follow the instructions in the installation guide.
  • Mac OS X: copy the downloaded file into your application folder.
  • Linux: extract the downloaded file, and open the arduino-ide file that will launch the IDE.
Arduino IDE 2.0 installation successful Windows Mac OS X Linux

If you have doubts, you can go to the Arduino Installation Guide.

Do you need an ESP8266 board? You can buy it here.

Recommended reading: Best ESP8266 Boards Comparison

Install ESP8266 NodeMCU Add-on in Arduino IDE

To install the ESP8266 board in your Arduino IDE, follow these next instructions:

1. In your Arduino IDE 2.0, go to File > Preferences.

Install ESP8266 NodeMCU Board Add-on in Arduino IDE 2.0

2. Copy and paste the following line to the Additional Boards Manager URLs field.

http://arduino.esp8266.com/stable/package_esp8266com_index.json
Additional URLs Field ESP8266 Arduino IDE 2.0

Note: if you already have the ESP32 boards URL, you can separate the URLs with a comma, as follows:

http://arduino.esp8266.com/stable/package_esp8266com_index.json,https://dl.espressif.com/dl/package_esp32_index.json

3. Open the Boards Manager. You can go to Tools > Board > Boards Manager… or you can simply click the Boards Manager icon at the left-side corner.

Arduino IDE 2.0 Boards Manager Dashboard

4. Search for ESP8266 and press the install button for esp8266 by ESP8266 Community.

Install ESP8266 NodeMCU boards Arduino IDE 2.0

That’s it. It should be installed after a few seconds.

Testing the Installation

To test the ESP8266 add-on installation, we’ll upload a simple code that blinks the on-board LED (GPIO 2).

Copy the following code to your Arduino IDE:

/*********
  Rui Santos
  Complete project details at https://RandomNerdTutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/
*********/

#include <Arduino.h>

#define LED 2

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);
  pinMode(LED, OUTPUT);
}

void loop() {
  // put your main code here, to run repeatedly:
  digitalWrite(LED, HIGH);
  Serial.println("LED is on");
  delay(1000);
  digitalWrite(LED, LOW);
  Serial.println("LED is off");
  delay(1000);
}

View raw code

Uploading the Sketch

On the top drop-down menu, select the “unknown” board. A new window, as shown below, will open.

Arduino IDE 2.0 Select ESP8266 Board and COM Port

You should select your ESP8266 board model and the COM port. In our example, we’re using the NodeMCU 1.0 board. Click OK when you’re done.

Now, you just need to click on the Upload button.

Arduino 2.0 Upload Button

After a few seconds, the upload should be complete.

ESP8266 NodeMCU Arduino IDE 2.0 Upload Successful Programming demonstration

The ESP8266 on-board LED should be blinking every second.

ESP8266 NodeMCU board running blink LED example code Arduino IDE 2.0

Serial Monitor

You can click on the Serial Monitor icon to open the Serial Monitor tab.

Open Arduino IDE Serial Monitor Arduino IDE 2.0 ESP8266 NodeMCU

That’s it! You’ve installed the ESP8266 Boards successfully in Arduino IDE 2.0.

Wrapping Up

This is a quick guide that shows how to prepare Arduino IDE 2.0 for the ESP8266 Boards on a Windows PC, Mac OS X, or Linux computer.

Remember that Arduino IDE 2.0 is an experimental software, so it might have some bugs, and some features might not be fully functional.

Next, you might want to read: Getting started with ESP8266 or learn more about the ESP8266 board with our resources:



Build Web Server projects with the ESP32 and ESP8266 boards to control outputs and monitor sensors remotely. Learn HTML, CSS, JavaScript and client-server communication protocols DOWNLOAD »

Build Web Server projects with the ESP32 and ESP8266 boards to control outputs and monitor sensors remotely. Learn HTML, CSS, JavaScript and client-server communication protocols DOWNLOAD »


Enjoyed this project? Stay updated by subscribing our newsletter!

2 thoughts on “Installing ESP8266 NodeMCU Board in Arduino IDE 2.0 (Windows, Mac OS X, Linux)”

  1. “Linux: extract the downloaded file, and open the arduino-ide file that will launch the IDE.”
    may sound simpler than it is. the only way that worked for me is from the command line by going to the proper directory and typing ./arduino-ide

    Reply
  2. Linuxmint: Your instructions were too glib and left out much complexity. I am erasing the entire mess and sticking with 1.8.15 until you and Arduino get the bugs out.

    Reply

Leave a Comment

Download our Free eBooks and Resources

Get instant access to our FREE eBooks, Resources, and Exclusive Electronics Projects by entering your email address below.