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.

Step 1 — Upload the firmware package on the server

Log in to the ThingsBoard Server and go to Advanced features → OTA updates.
Click Add (+) and fill in:
- Title: a descriptive name (for example, sensor-fw-v2.1)
- Version: the firmware version string
- Version tag: auto-populated from the version field; override only if it must match a specific string reported by the device
- Device profile: the profile of devices this firmware targets
- Type: Firmware
Either upload a binary file or switch to Direct URL and provide a download link.
Click Add.

Step 2 — Confirm propagation to Edge

The package is automatically pushed to all connected Edge instances.

Log in to the Edge instance and go to Advanced features → OTA updates.
Confirm the new package appears in the list.

Step 3 — Assign the firmware to a device or profile

On the Edge instance, go to Entities → Devices (or Profiles → Device profiles).
Open the target device or profile and click Edit.
In the Firmware field, select the uploaded package.
Click Save.

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

Monitor update progress

Go to Entities → Devices, open the device, and check the Attributes tab for the fw_state and fw_version keys to track download and installation progress.

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