Repository navigation
AKS desktop v0.11.0 adds Windows on Arm support and preview upgrade-readiness checks, alongside fixes for Azure connections, GitHub sign-in, and port forwarding from projects.
What's new
-
Windows on Arm now has its own installer. The app runs natively on ARM64; the bundled Azure CLI and Python use Windows 11 x64 emulation.
Installation note: On Windows ARM64, installing for all users defaults to Program Files (x86), but the app still runs natively on ARM64. You can select Program Files during installation.
-
You can disconnect GitHub from the project header. "Disconnect GitHub" removes the app's saved credentials across project views, without signing you out of your browser or revoking GitHub permissions. If removal fails, you can retry.
AKS enabled by Azure Arc (preview)
AKS Desktop can discover and connect to AKS clusters running on bare-metal infrastructure through Azure Arc (Hybrid & Edge), alongside your Azure-hosted AKS clusters. Select a subscription during cluster registration or in the Create Project wizard to find these clusters.
Finding clusters and checking their health is faster. Discovery failures now show the Azure error rather than an empty list or a misleading extension-install prompt. On Windows, connections no longer time out just because startup output was missed.
This preview covers AKS-provisioned Hybrid & Edge clusters, not arbitrary bare-metal Kubernetes clusters or generic Arc-connected clusters.
Upgrade Insights (preview)
Upgrade Insights lets you review stored readiness checks and request a new evaluation before planning an AKS upgrade. You can filter the cluster inventory, inspect individual checks, and follow remediation links.
Enable Upgrade Insights under Settings > Preview Features, then open Upgrade readiness from Home. The feature is off by default and requires access to the Azure public-cloud service preview and appropriate Azure permissions.
Generating an evaluation does not upgrade, drain, or remediate your cluster. Results are point-in-time checks, not a guarantee that an upgrade will succeed.
Performance
Listing Azure subscriptions and resource groups, finding clusters and projects, and checking Hybrid & Edge health are faster. These operations now call Azure REST APIs directly instead of starting an Azure CLI command for each lookup. Entra user searches also go directly to Microsoft Graph.
Fixes
- Azure commands work again in signed macOS ARM64 apps.
- Linux ARM64 packages include compatible Azure tools, fixing commands that could not run in 0.10.0.
- GitHub browser sign-in and token refresh work again.
- The "Port Forward" button is back in service details opened from a project.
- Managed namespace deletion waits for Azure to finish removing the namespace. Existing Keep/Delete retention policies are unchanged.
- Kubernetes API requests consistently identify the app as AKS Desktop with its version, operating system, and architecture, improving server-side diagnostics.
- Cluster registration works after removing the last context, including when the existing kubeconfig contains null collections. Existing configuration is preserved.
- Signed macOS ARM64 apps no longer crash immediately on startup, as observed in the release candidates.
- The AKS Desktop tray icon is restored, with improved high-resolution rendering on macOS.
AI Assistant
The bundled AI Assistant is updated to 0.5.0-alpha, with a fix for app translations not appearing consistently.
AI Assistant in AKS desktop showing diagnosis cards for unhealthy Kubernetes resources, with actions to open the resource, analyze again, or dismiss the diagnosis.
YAML review shows the target cluster above the manifest and on the Apply button, so you can check where a change will go before applying it.
Other changes
- The namespace wizard's home navigation control is labelled "Back to home" for screen readers.
- "Contact us" on the error screen opens an issue in the AKS Desktop repository with diagnostic details.
- Telemetry documentation explains what is collected and how to opt out. Data collection itself has not changed.
- Bundled dependencies have security updates. Some reported dependency advisories remain unresolved.
- Translations are refreshed across 18 languages.
- The extra AKS logo above “No clusters found” is removed. The app logo, message, and Add Cluster action are unchanged.
The project creation wizard, captured for the provider-registration update.
Included changes (56 PRs since 0.10.0)
Features and fixes
- #1084: Add the opt-in Upgrade Insights preview for reviewing and generating AKS upgrade-readiness evaluations. Thanks to skuchipudi295, evangelos (@skoeva), and Steve Griffith (@swgriffith).
- #1114: Add Windows ARM64 installers alongside x64. Thanks to Tom Gamble (@gambtho) and René Dudfield (@illume).
- #1115: Build Linux ARM64 packages with matching native Azure tools. Thanks to Tom Gamble (@gambtho).
- #1047: Add local GitHub disconnect in the project header. Thanks to Tom Gamble (@gambtho) and to Kasun Rajapakse (@kasunsjc) for reporting.
- #1048: Restore GitHub browser sign-in and token refresh. Thanks to Tom Gamble (@gambtho).
- #986: Fix Azure CLI launch failures after macOS signing. Thanks to René Dudfield (@illume).
- #1057: Fix Windows Hybrid & Edge cluster proxy readiness timeouts. Thanks to S Santhosh Nagaraj (@yolossn).
- #1001: Restore service port forwarding from project views. Thanks to Tejhan Diallo (@tejhan).
- #1006: Send crash reports to Azure/aks-desktop through Contact us. Thanks to René Dudfield (@illume) and to Tom Gamble (@gambtho) for reporting.
- #988: Restore AI Assistant's recognition of the AKS Desktop host. Thanks to René Dudfield (@illume).
- #1123: Update AI Assistant to 0.5.0-alpha and fix managed translations for compressed responses. Thanks to Tom Gamble (@gambtho).
- #851: Record namespace-creation cancellation on home navigation and label the control Back to home. Thanks to Tom Gamble (@gambtho).
- #1109: Identify the AKS Desktop version correctly in backend diagnostics. Thanks to Tom Gamble (@gambtho).
- #1110: Use a consistent AKS Desktop name, version, operating system, and architecture in Kubernetes API user agents across desktop platforms, without changing application profiles or storage paths. Thanks to Tom Gamble (@gambtho).
- #1135: Accept null kubeconfig collections during registration without resetting existing configuration. Thanks to Tom Gamble (@gambtho).
- #1136: Seed and verify macOS JIT entitlements to fix ARM64 startup crashes after release signing. Thanks to Tom Gamble (@gambtho) and evangelos (@skoeva).
- #1137: Restore AKS Desktop tray branding with high-resolution artwork. Thanks to evangelos (@skoeva).
- #1138: Remove redundant branding from the cluster empty state. Thanks to evangelos (@skoeva).
Performance
Resource lookups and status checks spend less time starting Azure CLI processes. Reusing cached tokens also avoids repeated credential requests.
- #1054: Reuse cached Azure tokens to avoid repeated credential requests during resource lookups. Thanks to Tejhan Diallo (@tejhan).
- #1081: Speed up subscription and resource group lookups by removing per-operation Azure CLI startup. Thanks to Tejhan Diallo (@tejhan) and to René Dudfield (@illume) for reporting.
- #1088: Speed up cluster and project discovery with direct, paginated Azure queries, while reporting truncated results. Thanks to Tejhan Diallo (@tejhan) and to René Dudfield (@illume) for reporting.
- #1073: Avoid Azure CLI startup when registering resource providers during project setup, preserving cancellation and subscription context. Thanks to René Dudfield (@illume).
- #1076: Remove Azure CLI startup from managed namespace deletion while still tracking completion and preserving retention policies. Thanks to René Dudfield (@illume).
- #1058: Make Hybrid & Edge health checks faster by querying Azure directly. Thanks to evangelos (@skoeva) and to René Dudfield (@illume) for reporting.
- #1105: Make Hybrid & Edge discovery faster with direct Azure requests and show discovery errors. Thanks to Tejhan Diallo (@tejhan).
- #1095: Avoid Azure CLI startup for Entra user searches, preserving manual entry and account/cloud isolation. Thanks to evangelos (@skoeva).
Security and release verification
- #961: Apply Insights plugin dependency audit fixes. Thanks to evangelos (@skoeva).
- #962: Apply AKS Desktop plugin dependency audit fixes. Thanks to evangelos (@skoeva).
- #1091: Update vulnerable npm dependencies and bundled Azure CLI Python packages. Thanks to evangelos (@skoeva).
- #1093: Add a workflow to sign release checksums and verify published assets. Thanks to evangelos (@skoeva).
- #1104: Pin CI npm installation by hash and use clean installs. Thanks to evangelos (@skoeva).
- #1107: Apply additional supported dependency security updates. Thanks to evangelos (@skoeva).
Documentation and maintenance
- #1050: Remove unused Azure CLI helpers without changing supported runtime operations. Thanks to evangelos (@skoeva).
- #876: Document telemetry collection and opt-out steps without changing telemetry behavior. Thanks to Tom Gamble (@gambtho).
- #989: Document how maintainers trigger 1ES release builds. Thanks to René Dudfield (@illume).
- #1055: Separate product branding into the aks-desktop-theme plugin. Thanks to René Dudfield (@illume).
- #1059: Update the Headlamp base, incorporating upstream fixes and refreshing patches and translations. Thanks to René Dudfield (@illume).
- #1087: Fix Windows development startup and bundled tool preparation. Thanks to Vincent T. (@vyncent-t).
- #1124: Refresh localized files against current main, incorporating translation updates from #899 and resolving conflicts. Thanks to René Dudfield (@illume).
Dependency and CI updates
- #817: Update knip from 6.24.0 to 6.29.0.
- #821: Update actions/checkout from 7.0.0 to 7.0.1.
- #1062: Update actions/upload-artifact from 7.0.1 to 7.0.2.
- #1064: Update actions/setup-node from 6.4.0 to 7.1.0.
- #1072: Update Insights plugin fast-uri from 3.1.8 to 3.1.9.
- #1094: Update AKS Desktop plugin Vite from 6.4.4 to 6.4.5.
- #1096: Update ossf/scorecard-action from 2.4.3 to 2.5.0.
- #1097: Update concurrently from 9.2.5 to 10.0.6.
- #1098: Update @playwright/test from 1.56.1 to 1.64.1.
- #1099: Update knip from 6.29.0 to 6.44.0.
- #1100: Update actions/upload-artifact from 7.0.1 to 7.0.2 in a separate PR.
- #1101: Update lint-staged from 17.0.8 to 17.6.0.
- #1108: Align CodeQL actions at v4.39.1. Thanks to evangelos (@skoeva).
- #1121: Update sigstore/cosign-installer from 4.1.2 to 4.1.3.
- #1126: Upgrade ESRP signing and notarization tasks to v6. Thanks to Tom Gamble (@gambtho).
- #1127: Temporarily baseline the Windows RC1 installer ASLR findings. Thanks to Tom Gamble (@gambtho).
- #1129: Extend the temporary installer ASLR baseline to RC2 and 0.11.0, expiring December 10, 2026. This exception does not fix the underlying ASLR limitation. Thanks to Tom Gamble (@gambtho).
Contributors
Thanks to Adam Sharif (@AdamSharif-MSFT), Daniel Sol (@danielsollondon), Tom Gamble (@gambtho), René Dudfield (@illume), Kasun Rajapakse (@kasunsjc), Paul Yu (@pauldotyu), Jann Röder (@roederja), evangelos (@skoeva), skuchipudi295, Steve Griffith (@swgriffith), Tejhan Diallo (@tejhan), Vincent T. (@vyncent-t), Will Case (@willspacecase), and S Santhosh Nagaraj (@yolossn).


