Azure Stack Hub servicing policy

Azure Stack Hub follows the Modern Lifecycle Policy. This article describes the servicing policy for Azure Stack Hub integrated systems and what you must do to keep your system in a supported state.

Download update packages for integrated systems

Microsoft releases both full update packages and hotfix packages to address specific issues.

Full update packages are hosted in a secure Azure endpoint. You can download them manually using the Azure Stack Hub Updates downloader tool. If your scale unit is connected, the update appears automatically in the administrator portal as Update available. For more information about each release, you can click any release from the Update package release cadence section of this article.

Hotfix update packages are hosted in the same secure Azure endpoint. You can download them using the embedded links in each of the respective hotfix KB articles; for example, Azure Stack Hub Hotfix 1.1809.12.114. Similar to the full, monthly update packages, Azure Stack Hub operators can download the .xml and .zip files and import them using the procedure in Apply updates in Azure Stack Hub. Azure Stack Hub operators with connected scale units will see the hotfixes automatically appear in the administrator portal with the message Update available.

If your scale unit isn't connected and you want to be notified about each hotfix release, subscribe to the RSS feed to be notified about each hotfix release.

Update package types

There are two types of update packages for integrated systems:

  • Microsoft software updates. Microsoft is responsible for the end-to-end servicing lifecycle for the Microsoft software update packages. These packages can include the latest Windows Server security updates, non-security updates, and Azure Stack Hub feature updates. You can download theses update packages directly from Microsoft.

  • OEM hardware vendor-provided updates. Azure Stack Hub hardware partners are responsible for the end-to-end servicing lifecycle (including guidance) for the hardware-related firmware and driver update packages. In addition, Azure Stack Hub hardware partners own and maintain guidance for all software and hardware on the hardware lifecycle host. The OEM hardware vendor hosts these update packages on their own download site.

Update package release cadence

Microsoft expects to release software update packages multiple times throughout the year.

OEM hardware vendors release their updates on an as-needed basis. Check with your OEM for the latest updates to hardware.

Find documentation on how to plan for and manage updates, and how to determine your current version in Manage updates overview.

For information about a specific update, including how to download it, see the release notes for that update:


Occasionally, Microsoft provides hotfixes for Azure Stack Hub that address a specific issue that's often preventative or time-sensitive. Each hotfix is released with a corresponding Microsoft Knowledge Base (KB) article that details the issues addressed in that hotfix.

Hotfixes are downloaded and installed just like the regular full update packages for Azure Stack Hub. However, unlike a full update, hotfixes can install in minutes. We recommend Azure Stack Hub operators set maintenance windows when installing hotfixes. Hotfixes update the version of your Azure Stack Hub cloud so you can easily determine if the hotfix has been applied. A separate hotfix is provided for each version of Azure Stack Hub that's still in support. Each hotfix for a specific iteration is cumulative and includes the previous hotfixes for that same version. You can read more about the applicability of a specific hotfix in the corresponding KB article. See the release notes links in the previous section.

Before you update to a new major version, apply the latest hotfix in the current major version. It is recommended that cloud operators keep their scale units updated with hotfixes as they are released; for example, installing hotfixes within 45 days of their release date, if possible.

Starting with build 2005, when you update to a new major version (for example, 1.2005.x to 1.2008.x), the latest hotfixes (if any are available at the time of package download) in the new major version are installed automatically. Your 2008 installation is then current with all hotfixes. From that point forward, if a hotfix is released for 2008, you should install it.

For information about currently available hotfixes, see the release notes "Hotfixes" section for that update.

OEM packages

Operators should maintain their OEM packages, and the recommendation is to be within N-2 OEM packages.

Keep your system under support

For your Azure Stack Hub instance to remain in a supported state, the instance must run the most recently released update version (N) or run either of the two preceding update versions (N-1, N-2). The following support restrictions apply to systems that aren't within our general two preceding versions support policy:

  • Hotfixes for the platform are provided for the current version and two preceding versions (N-1, N-2).
  • Root Cause Analysis (RCA) is provided for the current version and two preceding versions (N-1, N-2).
  • Issues on systems for unsupported versions (preceding N-2) are not entitled to receive support from Microsoft unless you're performing an update.

You must also have an active support agreement with the hardware partner that manufactured the system. Microsoft is not able to support you without a hardware support agreement in place.

Hotfixes aren't considered major update versions. If your Azure Stack Hub instance is behind by more than two updates, it's considered out of compliance. You must update to at least the minimum supported version (N-2) to receive support.

For example, if the most recent update version available is 2311 (N), the two previous update versions were 2306 and 2301, which means both 2306 (N-1) and 2301 (N-2) remain in support. However, the 2206 (and earlier) version is out of support, as 2206 was N-3 when the 2311 update was released. For the current release of Azure Stack Hub, the following versions are considered in support:

Microsoft software update packages are non-cumulative and require the previous update package and latest hotfix to be installed as a prerequisite. If you decide to defer one or more updates, consider the overall runtime required to update to the latest version.

Resource provider version support

For Azure Stack Hub resource providers, it's important to note that only the most recently released version of a given resource provider that is compatible with your supported version of Azure Stack Hub is supported, even though you may be using an older version of Azure Stack Hub that is still within the support window.

For more information about resource provider compatibility, see the release notes for that specific resource provider.

Get support

Azure Stack Hub follows the same support process as Azure. Enterprise customers can follow the process described in How to create an Azure support request. If you're a customer of a Cloud Solution Provider (CSP), contact your CSP for support. For more information, see the Azure Support FAQs.

For help with troubleshooting update issues, see Best practices for troubleshooting Azure Stack Hub patch and update issues.

Next steps