Skip to content
Stand with Ukraine flag
Star
 
Pricing Try it now

OTA updates

OTA updates on ThingsBoard Edge follow the same model as on the ThingsBoard server. Firmware and software packages are created on the server, automatically propagated to each connected Edge instance, and then assigned to devices or device profiles on the Edge.

OTA update flow: firmware package created on the ThingsBoard server is auto-propagated to the Edge instance, then assigned to a device or device profile to trigger the update

For a general overview of how OTA updates work, see OTA updates.

Create an OTA update package

Section titled “Create an OTA update package”

  1. Log in to your ThingsBoard server and go to Advanced features → OTA updates.

  2. Click Add (+) to open the new package dialog.

    Fill in the following fields:

    • Title: The firmware package name.
    • Version: The package version number.
    • Version tag: Populated automatically. Enter a custom value only if it must match the version string reported by the device.
    • Device profile: The target device profile.
    • Package type: Select Firmware or Software.
    • Source: Select Upload binary file to upload a file from your computer, or Use external URL to provide a download URL.

  3. Click Add.

    Once uploaded, the title, version, device profile, and package type cannot be modified.

  4. Confirm the package appears in the list.

Verify the package on Edge

Section titled “Verify the package on Edge”

After the package is created on the server, ThingsBoard automatically propagates it to all connected Edge instances.

  1. Log in to your ThingsBoard Edge instance and go to Advanced features → OTA updates.

  2. Confirm the package appears in the list.

    If the package is missing, check the Cloud Events log on the Edge instance for sync errors.

Deploy the package to devices

Section titled “Deploy the package to devices”

After the package is available on Edge, assign it to devices. You can assign it to a single device or to a device profile — any device using that profile, including devices added later, will receive the update automatically.

By device

Section titled “By device”

  1. Go to Entities → Devices and open the target device.

  2. Go to the Firmware or Software tab, depending on the package type.

  3. Select the package from the dropdown and click Apply.

    ThingsBoard Edge sends the update to the device. Monitor the update progress in the device’s Attributes — the fw_state or sw_state attribute changes from DOWNLOADING through UPDATING to UPDATED once the device confirms the new version.

By device profile

Section titled “By device profile”

  1. Go to Profiles → Device profiles and open the target profile.

  2. Go to the OTA updates tab.

  3. Select the firmware and/or software package and click Save.

    All current and future devices using this profile receive the update notification.

© 2026 The ThingsBoard Authors