Source: https://mokxi.com/errors/port-not-found
Updated: 2026-11-17

Home / Errors
Arduino upload error

# Port not found

The Arduino IDE has no port to send the sketch to. The computer does not list your board as a serial port.

Run the sketch in Mokxi first See the causes

- Upload error
- 4 common causes

The message

## What the Arduino IDE prints

Output window

That is a connection problem, not a code problem. The sketch itself can be fine.

Causes

## The 4 usual causes in order

### 1The USB cable only carries power

Many cables charge and nothing more. A board that powers up but never appears as a port is the sign.

- Try a different cable, ideally the one that came with a phone or another board that you know transfers data.
- Plug straight into the computer, not through a hub.

### 2The computer lacks the driver for the USB chip

Clone boards use a CH340 or CP210x chip. Windows and older macOS need its driver before a port appears.

- Look at the small square chip near the USB socket and read its name.
- Install the driver for that chip from its maker, then unplug the board and plug it in again.
- In Tools, Port, check that a new entry appears when you plug the board in.

### 3On Linux, your user cannot open serial ports

The port exists but belongs to a group your account is not in. The list then looks empty or the port is gray.

- Add your user to the group that owns serial ports, usually dialout, with sudo usermod -a -G dialout $USER.
- Log out and back in so the change applies.

### 4The board is in the wrong mode

A Leonardo, a Pico or an ESP32 can sit in a state where it shows no normal port.

- Press the reset button once and look at the port list again.
- For a Pico, unplug it, hold BOOTSEL and plug it in. For an ESP32, hold BOOT while it connects.

On a real board

## What to do at the bench

Change one thing at a time and look at Tools, Port after each. The moment a port appears, you have found the cause.

In Mokxi, Chrome or Edge shows its own port picker when you press Upload to board. If your board is not in that list, the same cable and driver causes apply.

### Test the sketch in Mokxi first

Run the sketch here before you blame the board. If it builds and runs in Mokxi, the code is fine and the fault is the connection to the real board. Mokxi never uploads in a simulation, so it cannot raise this error itself.

A sketch to try first

FAQ

## Questions and answers

### What does "Port not found" mean?

The IDE found no serial port to upload to. The board is not connected, not recognized, or not allowed to be opened.

### Is my board broken?

Rarely. A bad cable, a missing driver or a wrong mode are far more common. Try a second cable and a second computer before you give up on the board.

### Can I check my code without a port?

Yes. Compile in the IDE, or run the sketch in Mokxi. Neither needs a port.

Next

## More errors and the longer guide

- avrdude: stk500_getsync() attempt 1 of 10: not in sync: resp=0x00
- avrdude: ser_open(): can't open device "/dev/ttyACM0": Permission denied

The longer guide to the avrdude upload error All Arduino errors
