Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article explains which operating systems and components are supported by Device Update for IoT Hub (DU), whether generally available or in preview.
Get support
If you experience problems while using the Device Update service, there are several ways to seek support. Try one of the following channels for support:
Reporting bugs - The development that goes into the DU product happens in the Device Update open-source project. Bugs can be reported on the issues page of the project. Fixes rapidly make their way from the projects in to product updates.
Microsoft Customer Support team - Users who have a support plan can engage the Microsoft Customer Support team by creating a support ticket directly from the Azure portal.
Feature requests - The DU product tracks feature requests via the product's Device Update Discussions community.
Linux Operating Systems
Device Update can be used with a wide range of Linux operating systems; however, not all operating systems are supported by Microsoft. The systems listed in the following table are Linux distributions where the Device Update agent reference implementation can be built and run, and have been validated through automated testing with each release.
You can build the Device Update agent from source using the Device Update agent reference implementation, which serves as a starting point that can be adapted or extended for your device update needs. For more information, see how to build the device update agent.
It's possible to port the open-source Device Update agent to other operating systems. However, these builds aren't tested or maintained by Microsoft.
For some platforms, prebuilt installation packages may also be available.
| Operating System | AMD64 | ARM32v7 | ARM64 |
|---|---|---|---|
| Debian 11 (Bullseye) |  |
|
|
| Debian 12 (Bookworm) | |
|
|
| Debian 13 (Trixie) | |
|
|
| Ubuntu Server 20.04 | |
|
|
| Ubuntu Server 22.04 | |
|
|
| Ubuntu Server 24.04 | |
|
Releases and Support
You can find Device Update for IoT Hub release assets and release notes on the Device Update Release page.
The following table summarizes support for APIs, IoT Plug and Play (PnP) models, and Device Update reference agents.
Device Update agents use IoT Plug and Play (PnP) models to communicate with the service. The models listed in the following table identify the interfaces required for each agent version. For more information, see IoT Plug and Play in Azure Device Update for IoT Hub.
Use a current 1.x version of the Device Update agent reference implementation and consider the latest available version to benefit from improvements. The latest Device Update agent reference implementation version is 1.3.0.
| Release notes and assets | deviceupdate-agent | Upgrade Supported from agent version | DU PnP Models supported | API Versions |
|---|---|---|---|---|
| 1.3.0 | 1.3.0 |
1.1.0 | dtmi:azure:iot:deviceUpdateContractModel; 3 dtmi:azure:iot:deviceUpdateModel; 3 |
2022-10-01 |
| 1.2.0 | 1.2.0 |
1.1.0 | dtmi:azure:iot:deviceUpdateContractModel; 3 dtmi:azure:iot:deviceUpdateModel; 3 |
2022-10-01 |
| 1.1.0 | 1.1.0 | 1.0.x | dtmi:azure:iot:deviceUpdateContractModel; 3 dtmi:azure:iot:deviceUpdateModel; 3 |
2022-10-01 |
| 1.0.0 | 1.0.0 1.0.1 1.0.2 |
0.8.x | dtmi:azure:iot:deviceUpdateContractModel; 2 dtmi:azure:iot:deviceUpdateModel; 2 |
2022-10-01 |
| 0.0.8 (Preview)(Deprecated) | 0.8.0 0.8.1 0.8.2 |
dtmi:azure:iot:deviceUpdateContractModel; 1 dtmi:azure:iot:deviceUpdateModel; 1 |
2022-10-01 2021-06-01-preview (Deprecated) |
Newer REST service API versions support older agents unless otherwise specified. The Device Update portal experience uses the latest API version.
Note
Users that have extended from the reference agent and customized the agent are responsible for ensuring the bug fixes and security fixes are incorporated. You will also need to ensure the agent is built and configured correctly as defined by the service to connect to the service, perform updates, and manage devices from the IoT hub.
Important
Every Microsoft product has a lifecycle. The lifecycle begins when a product is released and ends when it's no longer supported. Knowing key dates in this lifecycle helps you make informed decisions about when to upgrade or make other changes to your software.
For Device Update for IoT Hub, no stable API or agent version will be deprecated without a replacing version. Deprecated stable versions will be available for no less than three years after deprecation is announced to allow users to migrate to in-support agent and API versions.
Preview releases (Prereleases) agents and APIs are not serviced after the release of the stable version. Preview versions are released to test new functionality, gather feedback, and discover and fix issues. Previews are available under Supplemental Terms of Use, and aren't recommended for production workloads.
0.7.0 (Prerelease) is not supported by the latest service and API versions.
With the latest stable release, we recommend that all current customers running 0.x.x upgrade their devices to 1.0.x to receive ongoing support.