Skip to content

Update upgrade instructions from 22H2 to Azure Stack HCI version 24H2 #4172

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Karl-WE wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update upgrade instructions from 22H2 to Azure Stack HCI version 24H2 #4172

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 0 additions & 70 deletions azure-local/deploy/download-23h2-software.md
View file
Open in desktop

This file was deleted.

70 changes: 70 additions & 0 deletions azure-local/deploy/download-24h2-software.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: Download Azure Stack HCI Operating System, version 24H2 software for Azure Local deployment
description: Learn how to download Azure Local, version 24H2 software from the Azure portal to deploy an Azure Local instance.
author: alkohli
ms.author: alkohli
ms.topic: how-to
ms.service: azure-local
ms.date: 09/24/2025
ms.subservice: hyperconverged
---

# Download operating system for Azure Local deployment

[!INCLUDE [hci-applies-to-23h2](../includes/hci-applies-to-23h2.md)]

This article describes how to download the operating system (OS) software from the Azure portal to deploy an Azure Local instance.

The first step in deploying Azure Local is to download the OS from the Azure portal. The software download includes a free 60-day trial. However, if you've purchased Integrated System or Premier solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner (OEM), the Azure Stack HCI OS should be preinstalled.
In that case, you can skip this step and move on to [Register your machines and assign permissions for Azure Local deployment](./deployment-arc-register-server-permissions.md).

## Prerequisites

Before you begin the download of the software from Azure portal, ensure that you have the following prerequisites:

| **Prerequisite** | **Instructions** |
|--------------|------------------|
| **Azure Tenant** | If you don’t already have an Azure Tenant, first create an Azure Tenant. <br> Ensure that you or your organization do not own an existing tenant to avoid shadow tenants, or issues with their applicable governance and licensing. <br><br> You can create an Azure Tenant by login in with your Microsoft personal or Business / School account by obtaining a free [PowerBI license](https://app.powerbi.com/home). The registered user will become the Global Administrator of this newly tenant. <br> If your organization already has an existing Azure tenant, please consult with your IT department, if Azure Local should be deployed in the existing tenant or adding a new tenant to comply with their applicable governance and Azure Local Licensing requirements. To learn to how add a new tenant, see [Create a new tenant](https://learn.microsoft.com//entra/fundamentals/create-new-tenant) |
| **Azure account** | An Azure account is required. first [create an account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
| **Azure subscription** | An Azure subscription. You can use a new or existing subscription of any type: <br> - Free account with Azure credits [for students](https://azure.microsoft.com/free/students/?cid=msft_learn) <br> - [Visual Studio subscribers](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/) or <br> - Pay-as-you-go subscription with credit card or <br> - Azure Subscription obtained through an Enterprise Agreement (EA) or <br> - Azure Subscription obtained through the Cloud Solution Provider (CSP) program or <br> - other eligible Azure Subscription types containing Azure (Extended) Credits.
| **RBAC Permissions** | At a minimum, you'll need Reader access at the subscription level. Additional RBAC requirements will be specified throughout the Ressource provider registration and deployment guidance. |
| **Resource provider registration** | Before downloading, register the Microsoft Azure Stack HCI resource provider to access the Azure Local OS image download. <br> For instructions on registering via Azure PowerShell through the Azure portal, see [Register required resource providers for Azure Local](deployment-arc-register-server-permissions.md#azure-prerequisites) in the Azure prerequisites section. <br> For general information on the registration procedure of Azure resource providers, see [Register resource provider](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider). |


## Download the software from the Azure portal

> [!IMPORTANT]
> English is the only supported language for the deployment.
> Make sure you have satisfied the permissions and resource provider registration, otherwise you may not be able to select a download of the Azure Stack HCI OS.

Follow these steps to download the software:

1. If not already signed in, sign in to [Azure portal](https://portal.azure.com/) with your Azure account credentials.
1. In the Azure portal search bar at the top, enter **Azure Local**. As you type, the portal starts suggesting related resources and services based on your input. Select **Azure Local** under the **Services** category.

:::image type="content" source="media/download-23h2-software/search-software.png" alt-text="Screenshot that shows how to search for Azure Local." lightbox="media/download-23h2-software/search-software.png":::

After you select **Azure Local**, you're directed to the Azure Local **Get started** page, with the **Get started** tab selected by default.

1. On the **Get started** tab, under the **Download software** tile, select **Download**. Skip this step if your Azure Local instance came installed with the OS.

:::image type="content" source="media/download-23h2-software/get-started-page-with-download-button.png" alt-text="Screenshot of the Get started page with the option to download the Azure Stack HCI OS." lightbox="media/download-23h2-software/get-started-page-with-download-button.png":::

1. On the **Download Azure Stack HCI** page, do the following:

1. Select the subscription in which you intend to deploy Azure Local. Ensure that the selected subscription has the Microsoft Azure Stack HCI resource provider registered and which you have **Reader** access at a minimum.

:::image type="content" source="media/download-23h2-software/download-azure-stack-hci.png" alt-text="Screenshot of the Download Azure Stack HCI OS version 23H2 page showing step 1." lightbox="media/download-23h2-software/download-azure-stack-hci.png":::

2. Select your desired version. Only the recommended version is eligible for deployment using Azure portal. To deploy a previous version, use an [Azure Resource Manager template](deployment-azure-resource-manager-template.md).

3. Select **I agree with Azure Local license terms and privacy notice** and then select **Download**.

:::image type="content" source="media/download-23h2-software/download-azure-stack-hci-step-2.png" alt-text="Screenshot of the Download Azure Stack HCI OS version 23H2 page showing step 2." lightbox="media/download-23h2-software/download-azure-stack-hci-step-2.png":::

> [!NOTE]
> This action begins the download. Use the downloaded ISO file to install the software on each machine that you want to cluster.

## Next steps

- [Install the Azure Stack HCI operating system](./deployment-install-os.md).