Edit

Share via


Quickstart: Enable Azure Linux 3.0 for Azure Kubernetes Service (AKS) clusters and node pools

Starting with AKS version 1.32, Azure Linux 3.0 is the default Azure Linux node OS for AKS clusters and node pools.

Important

As of November 30, 2025, Azure Kubernetes Service (AKS) no longer supports or provides security updates for Azure Linux 2.0. The Azure Linux 2.0 node image is frozen at the 202512.06.0 release. Beginning March 31, 2026, node images will be removed, and you'll be unable to scale your node pools. Migrate to a supported Azure Linux version by upgrading your node pools to a supported Kubernetes version or migrating to osSku AzureLinux3. For more information, see Retirement: Azure Linux 2.0 node pools on AKS.

Create new Azure Linux 3.0 clusters and node pools

Any new AKS clusters or node pools created using the --os-sku=AzureLinux flag and that run AKS version 1.32 default to Azure Linux 3.0. You can deploy clusters or node pools using the method of your choice to use Azure Linux 3.0 as the node OS:

Upgrade existing Azure Linux 2.0 clusters and node pools to Azure Linux 3.0

To upgrade existing Azure Linux 2.0 clusters and node pools to Azure Linux 3.0, you can upgrade them to AKS version 1.32. For more information about AKS cluster upgrades, see Upgrade an AKS cluster.

Alternatively, starting with Kubernetes version 1.28+, you can perform an in-place node pool update from --os-sku AzureLinux to --os-sku AzureLinux3, enabling you to migrate existing node pools from Azure Linux 2.0 to 3.0 while remaining on the same Kubernetes version. Your node pool will automatically reimage to the equivalent Azure Linux 3.0 node image. See documentation here.

Next steps

For more information about Azure Linux 3.0, see What's new with Azure Linux 3.0?.