ATmega328P/Install, then the first upload/01. Install the Arduino IDE
Install, then the first upload · 01 of 33

Install the Arduino IDE

Arduino IDE 2 is free from arduino.cc for Windows, macOS and Linux. Installing it is a download and a copy; the step people miss is the first start, when the IDE fetches the package that contains the Uno and the Nano.

Your board

Which download

Arduino's software page, arduino.cc/en/software, offers the IDE for each operating system. Take the first one that matches yours:

  • Windows 10 or newer, 64-bit: the installer. An MSI and a ZIP are there for managed and portable installs.
  • macOS 10.15 Catalina or newer: the disk image for your Mac's processor, Apple Silicon or Intel. About This Mac says which.
  • Linux, 64-bit: the AppImage, a single file that is the whole IDE.

The page also offers the older IDE 1.8. This book uses Arduino IDE 2, and the menus it names are that version's.

The steps

Installing Arduino IDE 2
Windows
Your computer
Five steps, and the fourth is the one people miss. The IDE fetches the board package for the Arduino Uno from the internet the first time it starts. Press Install to walk through it.

Choose your system and press Install. On Windows the installer does the work. On a Mac the app is copied into Applications and macOS asks once whether to open something downloaded from the internet. On Linux the AppImage has to be made executable first, and it needs FUSE: on Ubuntu 22.04 and later that is the libfuse2 package.

chmod +x arduino-ide_*_Linux_64bit.AppImage
sudo apt install libfuse2      # Ubuntu 22.04 and later, if it will not start

The first start fetches the boards

The IDE installs with no boards in it. The first time it starts, it downloads Arduino AVR Boards: the compiler, the uploader (avrdude) and the board definitions for the Uno, the Nano and their relatives. A notification shows the progress. It needs the internet, and until it finishes, Arduino Uno is not in the Board menu.

If the download fails, the IDE says Could not install Arduino AVR platform and tries again at its next start. You can also install it by hand from the Boards Manager, the second icon in the bar down the left side: search for Arduino AVR Boards and press Install.

What you should see

The IDE opens on a new sketch with two empty functions, setup() and loop(). Open Tools > Board > Arduino AVR Boards and Arduino Uno is in the list. That is everything the IDE needs; whether the computer can see the board is the next article.

When it does not work

Arduino Uno or Arduino Nano is not in Tools, Board

The first-start download of Arduino AVR Boards did not finish, usually for want of an internet connection. The IDE tries again at its next start. Or open the Boards Manager (the second icon down the left side), search for Arduino AVR Boards, and press Install.

Could not install Arduino AVR platform

That is the IDE saying its first-start download failed. Check the connection, then close and reopen the IDE; it retries by itself until the download succeeds. A proxy or a firewall that blocks downloads.arduino.cc gives the same message.

The Linux AppImage does nothing when double-clicked

It is not marked as executable yet, or FUSE is missing. Allow executing it in the file's Properties, or run chmod +x on it; on Ubuntu 22.04 and later install the libfuse2 package as well.

macOS will not open the app

Open it from Applications rather than from inside the disk image, and answer Open when macOS asks about an app downloaded from the internet. If you dragged the Intel copy onto an Apple-silicon Mac it still runs, but the Apple Silicon download is the one to use.

Where this goes next

Why the computer may not see the board yet, and the driver from WCH that fixes it.

The CH340 driver →

Edit this page — content/books/atmega328p/install-the-arduino-ide.mdx

Discuss this article

Ask about this page. The answer stays here, on the page it belongs to, for whoever hits the same wall next.

Browse Modules and blocks on the forum →