Azure / Azure/AKS

[Retirement] The enableCustomCATrust preview property retires on 14 September 2026.

Open
#5,826 1 comment 0 reactions 1 assignee Claimed by @allyford View on GitHub
announcement deprecation stale
Dominant language
TypeScript
Stars
2.1k
Forks
395
Avg merge
2d 22h
Merged PRs (30d)
13

Description

On 14 September 2026, the preview property `enableCustomCATrust` will retire. After that date, `enableCustomCATrust=true` node pool level field will no longer enable the Custom Certificate Authority (CA) feature in AKS.

The last preview API that supports this property is 2025-08-02-preview.

Existing node pools that still rely on enableCustomCATrust=true might experience failures during scaling operations or when certificates are updated.

### Required Action
To avoid service disruption, update the impacted clusters and node pools and remove the preview property before 14 September 2026.

**Update your node pools to remove the Custom CA Trust property:**

az aks nodepool update \
  --resource-group \
  --cluster-name \
  --name \
  --disable-custom-ca-trust

**Update your clusters to remove the Custom CA Trust property:**
az aks update \
  --resource-group \
  --name \
  --disable-custom-ca-trust

If you want Custom CA Trust enabled on your clusters after this retirement, use --custom-ca-trust-certificates and provide a path to a certificate file. For more information, see [AKS Custom Certificate Authority documentation](https://learn.microsoft.com/azure/aks/custom-certificate-authority).

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.