Skip to main content
Calico Cloud documentation

Uninstall Calico Cloud from a cluster

Whether you've finished with your Calico Cloud Trial or decided to disconnect your cluster from Calico Cloud, we know you want your cluster to remain functional. We highly recommend running a simple script to migrate your cluster to open-source Project Calico.

About the migration script​

The script migrates all applicable Calico Cloud components to open-source Project Calico; this includes removal and cleanup of all Calico Cloud components that have no equivalents in Project Calico. Because Project Calico does not have the tier resource, the script will exit if any policies exist in any tier except for the default or allow-tigera tiers. To remove policies from tiers, you have these options:

  • Manually move policies out of tiers prior to running the script
  • Let the script remove ALL Calico policies by specifying the --remove-all-calico-policy flag
note

To successfully downgrade to an open-source Calico configuration, policies must allow necessary traffic to and from Calico Cloud and open-source Calico namespaces. If you keep policies in the default tier (especially GlobalNetworkPolicies), and you have default deny policies, update or add policies accordingly to allow this necessary traffic.

warning

If your cluster began with Calico installed and managed by AKS with AddonManager, this uninstall process will not be successful. You will need to reach out to your support contact to create a plan to uninstall Calico Cloud.

Before you begin​

  • You have kubectl administrator access to the cluster you want to migrate to Calico Open Source.
  • You are accessing the cluster from a Linux-based machine.

Run the migration script​

  1. Download the script curl -O https://installer.calicocloud.io/manifests/v3.20.0-1.0-18/downgrade.sh.

  2. Make the script executable chmod +x downgrade.sh.

  3. Run the script and read the help to determine if you need to specify any flags ./downgrade.sh --help.

  4. Run the script with any needed flags, for example: ./downgrade.sh --remove-prometheus.

Next steps​

Continue using your cluster with open-source Project Calico.