Uninstall the Open Service Mesh (OSM) add-on from your Azure Kubernetes Service (AKS) cluster

This article shows you how to uninstall the OMS add-on and related resources from your AKS cluster.

Important

Starting on September 30, 2027, Azure Kubernetes Service (AKS) no longer supports the Open Service Mesh (OSM) add-on. The Cloud Native Computing Foundation (CNCF) retired the upstream OSM project. Migrate any existing OSM configurations to equivalent Istio configurations. For more information on this retirement, see the Azure Updates retirement announcement. To stay informed on announcements and updates, follow the AKS release notes.

Disable the OSM add-on from your cluster

  • Disable the OSM add-on from your cluster using the az aks disable-addon command and the --addons parameter.

    az aks disable-addons \
  --resource-group myResourceGroup \
  --name myAKSCluster \
  --addons open-service-mesh

Remove OSM resources

  • Uninstall the remaining resources on the cluster using the osm uninstall cluster-wide-resources command.

    osm uninstall cluster-wide-resources

    Note

    For version 1.1, the command is osm uninstall mesh --delete-cluster-wide-resources

    Important

    You must remove these additional resources after you disable the OSM add-on. Leaving these resources on your cluster may cause issues if you enable the OSM add-on again in the future.

Next steps

Learn more about Open Service Mesh.

  • Last updated on