About Azure Local upgrades

Applies to: Azure Local, versions 23H2 and 22H2

Important

Azure Stack HCI is now part of Azure Local. Product documentation renaming is in progress. Textual changes are complete, and visual updates will be finalized soon. Learn more.

This article provides an overview of upgrading Azure Local, version 22H2 to version 23H2.

Throughout this article, we refer to Azure Local, version 23H2 as the new version and Azure Local, version 22H2 as the old version.

About Azure Local, version 23H2

The latest version of Azure Local, version 23H2, integrates the Azure Arc infrastructure that provisions and manages the workloads such as Arc VMs, Azure Kubernetes Services, and Azure Virtual Desktop. For more information, see What's new in Azure Local, version 23H2.

With version 23H2, Azure Local evolved from a cloud-connected operating system (OS) to an Arc-enabled solution. The OS forms the base layer of this solution, with the Arc and the Orchestrator (also known as the Lifecycle Manager) components layered on top. These components are packaged together into a solution that follows an Infrastructure as code (IaC) model.

  • This IaC model takes a set of input parameters that are specific to each customer and environment.
  • The lifecycle manager then orchestrates the desired state across all the layers to meet the desired state and version.

The following diagram illustrates the components of the new version of Azure Local:

Diagram that illustrates Azure Local and its components.

Azure Local upgrade versus update

An upgrade is a whole new version of software that represents a significant change or major improvement. An update, on the other hand, is a process of applying a set of changes to the software to improve its performance, security, or stability.

Azure Local, version 23H2, is a new version of the solution with a multitude of new capabilities. To move from Azure Local, version 22H2 to version 23H2, you need to upgrade your existing system. On the other hand, to ensure that you have the most recent features and security improvements for your current version of Azure Local, you would need to update your existing system.

High-level steps for Azure Local upgrade

To upgrade Azure Local from an older version, follow these high-level steps:

  1. Upgrade the old OS to the new OS using one of the following methods:

  2. Perform post-OS upgrade tasks.

  3. Validate the solution upgrade readiness.

  4. Apply the solution upgrade.

The following diagram illustrates the Azure Local upgrade process:

Diagram that illustrates the two steps to upgrade the OS and then apply the solution update.

Supported workloads and configurations

Azure Local upgrade supports the following services and workloads:

Workload/Configuration Currently supported
Azure Kubernetes (AKS) on Azure Local See notes
Kubernetes versions are incompatible between Azure Local, version 22H2, and version 23H2.
Remove AKS and all the settings from AKS enabled by Azure Arc before you apply the solution upgrade.
Arc VMs on Azure Local See notes
Preview versions of Arc VMs can't be upgraded.
Stretched clusters on Azure Local Yes
You must upgrade to Azure Stack HCI Operating System, version 23H2 to maintain your cluster in a supported state.
The solution upgrade isn't available for stretched clusters.
System Center Virtual Machine Manager (SCVMM) Yes
If your Azure Local instance running version 22H2 is managed by SCVMM 2025, the OS upgrade is supported.
Azure Local, version 22H2SP No
This upgrade process isn't supported for upgrading from Azure Local, version 22H2 Supplemental Package clusters.

Next steps

Choose one of the following options to upgrade your Azure Local, version 22H2 to Azure Local, version 23H2: