Install the Arduino IDE

Tutorial · Arduino IDE 2.x (current line is 2.3.x) · Focus: Windows 10/11, with short macOS and Linux notes

This walkthrough gets the Arduino IDE 2 desktop app installed so you can write sketches, compile, and upload to boards. Prefer the official download only — random “Arduino IDE” installers from other sites are a common malware vector.

What you need

• A 64-bit PC: Windows 10 or newer (this guide’s main path), or macOS 10.15+, or 64-bit Linux
• Admin rights to install software (Windows EXE/MSI)
• Network access for the first launch (IDE may download board cores and updates)
• Optional later: a USB cable and board (Uno, Nano, ESP32, etc.) — not required just to install the IDE

1. Download from Arduino

1. Open the official software page: https://www.arduino.cc/en/software
2. Under Arduino IDE 2, choose your platform download.
3. For most Windows PCs pick the Windows Win 10 and newer, 64 bits installer (.exe). Alternatives:
   • .msi — better for managed / IT deployment
   • .zip — portable (no traditional install; extract and run)

2. Install on Windows

1. Close any older Arduino IDE windows.
2. Run the downloaded .exe (SmartScreen may ask you to confirm — choose More info → Run anyway only if you downloaded from arduino.cc or the official GitHub release).
3. Accept the license and use the default install location unless you have a reason not to (typical: C:\Program Files\Arduino IDE).
4. Finish the wizard. Leave Run Arduino IDE checked if you want it to open immediately, or start it later from the Start menu → Arduino IDE.

3. First launch checklist

1. Allow Windows Firewall / defender prompts if the IDE needs network access for updates and board packages.
2. Sign-in to an Arduino account is optional for local editing and upload. You can skip it for now.
3. Open File → Examples → 01.Basics → Blink to confirm the editor loads examples.
4. Open Tools → Board and note the default board list (classic AVR boards ship with the IDE; ESP32 and many others are added via Boards Manager later).

4. Add board support (when you have a board)

When you plug in a board that is not in the default list (for example many ESP32 modules):

1. Go to Tools → Board → Boards Manager…
2. Search for the platform (e.g. “esp32”) and install the package from Espressif or the board vendor.
3. Select the exact board under Tools → Board, then the COM port under Tools → Port.

Clone boards with CH340 / CP2102 USB chips sometimes need a vendor USB driver on Windows before a COM port appears. Install only from the chip maker’s site or your board vendor’s docs.

5. macOS and Linux (short)

Official install article: Download and install Arduino IDE (Arduino Help Center)

6. Verify install success

• Arduino IDE starts from the Start menu without an immediate crash
• Examples menu is populated
• Sketch → Verify/Compile works on the Blink example (even with no board connected)
• When a board is connected: a COM port appears and Upload succeeds

Troubleshooting

• No COM port: try another cable (charge-only cables are common), another USB jack, Device Manager for unrecognized devices, then CH340/CP2102 drivers if needed.
• Upload fails / avrdude errors: confirm Board + Port match the hardware; press the board reset at the right time on some clones; close serial monitors from other apps.
• IDE won’t start: update GPU drivers; try running from the ZIP portable build; check Arduino’s GitHub issues for your version.
• Corporate PC: use the MSI and ask IT to allow Arduino IDE and serial driver installation.

What’s next on this site

• Microcontrollers Overview
• Later topics: first Blink upload, serial monitor, Boards Manager deep dive, ESP32 setup

Sources: Arduino Software page, Arduino Help Center install article, Arduino IDE GitHub releases (2.3.x).