Firmware OTA Update via Edge

OTA firmware packages are created on the ThingsBoard server, automatically propagated to all connected Edge instances, and then assigned to devices or device profiles on Edge. This recipe walks through the complete workflow.

1. Log in to the ThingsBoard server and go to Devices & assets > OTA updates.
2. Click Add package and fill in:
   • Title: a descriptive name (for example, sensor-fw-v2.1)
   • Version: the firmware version string
   • Version tag: auto-populated from the title and version (<title> <version>); override only if it must match a specific string reported by the device
   • Device profile: the profile of devices this firmware targets
   • Package type: Firmware
3. Either upload a binary file, or select Use external URL and enter the download link in Direct URL.
4. Click Add.

The package is automatically pushed to all connected Edge instances.

1. Log in to the Edge and go to Devices & assets > OTA updates.
2. Confirm the new package appears in the list.

1. On the Edge, go to Devices & assets > Devices (or Devices & assets > Device profiles).
2. Open the target device or profile and click the pencil icon (Toggle edit mode).
3. In the Assigned firmware field, select the uploaded package.
4. Click Apply changes.

ThingsBoard Edge notifies the device of the available update. The device retrieves the firmware chunks over its active transport (MQTT, CoAP, or HTTP).

Go to Devices & assets > Devices, open the device, and check the Latest telemetry tab for the fw_state key (and current_fw_version once the device reports it) to track download and installation progress. The fw_title and fw_version shared attributes show the assigned target package.

For the full OTA reference including software updates and attribute keys, see OTA updates.