Skip to content

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

Closed

Description

@allyford

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.

Activity

  1. microsoft-github-policy-service commented on Sep 10, 2026

    @microsoft-github-policy-service
    Contributor

    This announcement has been automatically marked as stale because it has not had any activity for 90 days. It will be closed if no further activity occurs within 7 days of this comment.

  2. microsoft-github-policy-service commented on Sep 17, 2026

    @microsoft-github-policy-service
    Contributor

    This issue will now be closed because it hasn't had any activity for 7 days after stale. Ally Ford (@allyford) feel free to comment again on the next 7 days to reopen or open a new issue after that time if you still have a question/issue or suggestion.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

announcementdeprecationIssue relates to a deprecation of a feature or capability in AKSstaleStale issue

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions