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.
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
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 startThe 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
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.
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.
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.
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.
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.