Back to Arduino Support

Add a device to Arduino Cloud

Learn how to add supported devices to Arduino Cloud. For a more comprehensive introduction to Arduino Cloud, see Getting Started With the Arduino Cloud.

In this article:

For troubleshooting, see If your device can’t be added to Arduino Cloud.

Add an Arduino board via serial (USB)

Important

If you’re setting up an UNO Q, see Add an Arduino UNO Q.

The Arduino Cloud Agent lets you automatically configure most Cloud-supported Arduino boards via USB.

Follow these steps:

  1. Open the Devices tab in Arduino Cloud.

  2. Click on the Add Device button.

  3. Select Arduino boards.

  4. Connect your board to your computer and select it from the list.

    • If you don’t see your board, try disconnecting and reconnecting it.

    • If your board is still not detected, try double-pressing the reset button.

  5. Confirm the board selection by clicking Continue.

  6. Wait for Arduino Cloud to make any needed firmware updates. If prompted, disconnect and reconnect the board.

  7. Device configuration.

    • Device name. Use the default name, or change it. The device name can be changed later.
    • Network. Input network credentials. If the option does not appear, you can configure this later in the device tab.
    • Device Setup / Device Provisioning.

  8. After the configuration is complete, the device details page will open automatically.

    • If you configured the network credentials in a previous step (available on supported devices only), it will connect to Arduino Cloud and appear as ONLINE after a few seconds.
    • If the network credentials were not configured in the previous step, the device will be OFFLINE until you associate the device to a Thing and upload the sketch to the device.

Add an Arduino board via Bluetooth

You can add supported devices via Bluetooth if they are running the preflashed provisioning sketch. When this sketch is active, the onboard LED blinks in a heartbeat pattern (one long pulse followed by two short pulses).

Tip

If your board is running a different sketch, you can add it via USB instead, or manually flash the provisioning sketch.

Supported boards:

  • Arduino GIGA R1 WiFi
  • Arduino MKR WiFi 1010
  • Arduino Nano 33 IoT
  • Arduino Nano RP2040 Connect
  • Arduino Nicla Vision
  • Arduino Opta WiFi
  • Arduino Portenta H7
  • Arduino UNO R4 WiFi

Follow these steps:

  1. Open the Devices tab in Arduino Cloud.

  2. Click on the Add Device button.

  3. Select Arduino boards.

  4. Select Via Bluetooth.

  5. Select Select Device.

    • If prompted, enable Bluetooth for your web browser. Then, restart your web browser and repeat the previous steps.

  6. Select and pair your device in the browser dialog.

    If your device does not appear, try the following:

    • Ensure that your device is powered.
    • Reset the board’s Cloud configuration:
      • GIGA R1 WiFi: Connect Pin 7 and GND, until the LED turns off.
      • UNO R4 WiFi: Connect Pin 2 and GND, until the LED turns off.
    • Add the board via Serial (USB) instead.

  7. Confirm that the LED on your device is solid and select Continue.

  8. Device configuration.

    • Device name. Use the default name, or change it. The device name can be changed later.
    • Network. Input network credentials.
    • Device Setup / Device Provisioning.

  9. After completing the device configuration, the device status page will open automatically. The device will connect to Arduino Cloud and appear as ONLINE after a few seconds.

Add an Arduino UNO Q

Set up your UNO Q like a Python board on Arduino Cloud, then use Arduino App Lab to add the Cloud brick, combine Python and Sketch, and start building smarter projects.

  1. Open the Devices tab in Arduino Cloud.

  2. Click on the Add Device button.

  3. Under Manual device, select Arduino UNO Q.

  4. Select Arduino UNO Q and click Continue.

  5. Device configuration:

    • Give a name to the Device. Use the default name, or change it. The device name can be changed later.
    • Set up device. Copy or download Device ID and Secret Key.

  6. Tick the checkbox to confirm and click Continue.

  7. After the configuration is complete, the device details page will open automatically. The device will be OFFLINE until you’ve configured the connection on your UNO Q. This can be done in Arduino App Lab by configuring the Arduino Cloud Brick with your Device ID and Secret Key.

Learn more about connecting UNO Q to Arduino Cloud

Add a compatible ESP32, ESP8266, or LoRaWAN device

Secrets: Secret keys cannot be recovered if lost. Make sure to save any Device ID and Secret key that’s provided when adding an Arduino UNO R4 WiFi, Arduino Nano ESP32, or a 3rd party device (ESP32 and ESP8266).

  1. Open the Devices tab in Arduino Cloud.

  2. Click on the Add Device button.

  3. Select Compatible device.

  4. Device provisioning.

    1. Select device type

      • ESP8266. Select your ESP8266 in the list, then click Continue.
      • ESP32. Select your ESP32 in the list, then click Continue.
      • LoRaWAN. Select the following:
        • Select region. Make sure you select the right frequency band for your region.
        • DevEUI. A unique 64-bit identifier for your LoRaWAN device. Once you’ve registered a device, you can find its DevEUI within the device’s details page in your TTN application. Many LoRaWAN devices also have their DevEUI printed on a label or sticker on the device itself.

    2. Device name. Use the default name, or change it. The device name can be changed later.

    3. Set up device. Wait for the process to complete. If prompted, save your Device ID and Secret Key.

  5. After the configuration is complete, the device details page will open automatically. The device will be OFFLINE until you associate the device to a Thing and upload the sketch to the device.

Troubleshooting:

  • Error creating Lora device. Ensure that the DevEUI is correct and not already in use.

Add a manually configured device running Python, MicroPython, or Node.js

  1. Open the Devices tab in Arduino Cloud.

  2. Click on the Add Device button.

  3. Select Any device under the Manual Setup section.

  4. Confirm the information about manually configured devices by selecting Continue.

  5. Device provisioning.

    • Select device type. No input required.
    • Give a name to the Device. Use the default name, or change it. The device name can be changed later.
    • Set up device. Save your Device ID and Secret Key. Tick the checkbox to confirm and click Confirm.

  6. After the configuration is complete, the device details page will open automatically. The device will be OFFLINE until you’ve configured it to connect to Arduino Cloud using the Device ID and Secret Key you saved in the previous step.

Learn more about manually configured devices:

If you need help

See If your device can’t be added or won’t connect to Arduino Cloud.

  • Last edited:
Was this article helpful?
Do you want to contribute? Visit the Github repository
Return to top

Didn’t find what you were looking for?

Arduino Docs

Tutorials, data sheets, guides and other technical documentation.

Arduino Forum

Connect with the community, get help with your project, and discuss everything Arduino.

Arduino Discord

There are a lot of Arduino enthusiasts who are more than willing to help out. Head over Discord to start a discussion.

Contact Arduino

Need help with a product, need to make an exchange, or can't find a question answered? Email us and we'll answer as soon as possible.