On Linux, udev rules configure the system to recognize Arduino boards and grant your user account the necessary permissions to access, upload code, and debug. Missing or incorrect udev rules can result in failed board detection or uploads, as Arduino IDE and other development tools will not be able to access the board.

You can resolve the issue by configuring the required rules using an automated bash script.

---

In this article:

• Related Error Messages
• Automatic configuration
• Resources

Related Error Messages

If your udev rules are missing or configured incorrectly, you may see one of these error messages:

• dfu-util: Cannot open DFU device 2341:0366 found on devnum X (LIBUSB_ERROR_ACCESS)
• dfu-util: No DFU capable USB device available
• Error: unable to open CMSIS-DAP device 0x2341:<Product_ID>
• Error: unable to find a matching CMSIS-DAP device
• avrdude: jtagmkII_getsync(): sign-on command: status -1
• avrdude: usbdev_open(): cannot open device: Permission denied
• Error: exit status 1: adb: insufficient permissions for device: missing udev rules? user is in the plugdev group

---

Automatic configuration

You can configure rules for all Arduino boards by downloading and running arduino-udev-setup.sh.

Follow these steps to download and run the script:

Step 1: Download the script

You can download the script either using your web browser or directly in the terminal:

• Option A (Web Browser): Download arduino-udev-setup.sh directly.

• Option B (Terminal): Open your terminal and run one of the following commands to download the file directly into your current directory:

  wget https://content.arduino.cc/assets/arduino-udev-setup.sh
  

  or

  curl -O https://content.arduino.cc/assets/arduino-udev-setup.sh
  

Step 2: Open the terminal and navigate to the file

If you downloaded the file via Web Browser:

Open your Terminal and navigate to your downloads folder manually:

cd ~/Downloads

Step 3: Run the script as root

The script needs to create a configuration file in a system directory (/etc/udev/rules.d/) and reload the udev service, which requires administrator (root) privileges.

Run the script using bash:

sudo bash arduino-udev-setup.sh

When prompted, enter your Linux user password and press Enter.

Step 4: Reconnect your board

Once the script completes successfully:

1. Unplug your Arduino board from the USB port.
2. Plug the board back into the USB port.

This forces the system to reload and apply the new udev rules to your device. Try uploading your sketch again in Arduino IDE!

---

Resources

• View the script source code on GitHub to inspect or contribute to the code.