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.
Starting with AKS version 1.32, Azure Linux 3.0 is the default Azure Linux node OS for AKS clusters and node pools.
Important
Starting on 30 November 2025, AKS will no longer support or provide security updates for Azure Linux 2.0. Starting on 31 March 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:
- Quickstart with CLI
- Quickstart with PowerShell
- Quickstart with Terraform
- Quickstart with Azure Resource Manager (ARM)
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?.