Comment on page

Adding Your First Device

Add your device to a balenaCloud fleet

What You Will Need?

This guide assumes you will be using a Raspberry Pi 4. The instructions are the same for the UP and Intel NUC devices with the exception of loading the initial balenaOS onto your device.
More information and instructions for adding other device types can be found here.
  1. 1.
    A balenaCloud account with Microservices access (this requires a paid account)
  2. 2.
    A balenaCloud Raspberry Pi 4 Fleet (see Creating a Fleet)
  3. 3.
    A Raspberry Pi 4 with minimum 1Gb RAM and 8Gb storage (eMMC or microSD card. The following instructions are for an SD card)
  4. 4.
    A power supply for your Raspberry Pi 4
  5. 5.
    An Ethernet network cable
  6. 6.
    An internet router with a free Ethernet port (or an Ethernet port on your LAN with internet access)
  7. 7.
    An SD card adaptor for your laptop or PC
  8. 8.
    balenaEtcher installed on your laptop or PC. You can download balenaEtcher here

Adding a Device

Navigate to your balenaCloud dashboard and login in
Navigate to the Fleets page
Click on the fleet you want to add a device to
Click on the Add device button
Add a new device
Leave all of the default settings. You can add a WiFi network (client or AP) later.
Select the Download balenaOS option in the drop down button. The balenaOS will start to download
Add new device details

Burning the balenaOS onto the SD Card

Place your microSD card into your SD card adaptor and connect it to your laptop or PC
All data on your SD card will be overwritten!
Open balenaEtcher
Select Flash from file and choose the balenaOS image you downloaded above
Select your SD card as the target
Click on the Flash button
balenaEtcher will burn the balenaOS to your SD card and make it a bootable image. Wait for this to complete and for the image to be verified
Remove the SD card from the SD card adaptor and insert it into your Raspberry Pi 4's SD card slot
Plug the Ethernet cable into your Raspberry Pi 4's Ethernet port and your network
Power up your Raspberry Pi 4

Confirming Your Device is Connected to balenaCloud

After a few minutes your new device will appear in the balenaCloud dashboard. Navigate to your balenaCloud dashboard, select your fleet and view the fleet's Summary page.
You device will be added to the list at the bottom of the page. It will be given a random name which you can change on the device's summary page
If your device does not appear in the list, check that it is powered up and that the network port you have it plugged into has an internet connection.
Viewing the fleet's device list
You have successfully added a new device to your balenaCloud fleet. To deploy MobiusFlow® to this device go to Deploy MobiusFlow® to Your Fleet