Uninstall hybrid runtime

You are currently viewing version 1.8 of the Apigee hybrid documentation.This version is end of life. You should upgrade to a newer version. For more information, seeSupported versions.
NOTE: To uninstall successfully, you must havekubectl version 1.11.x or later installed.

To deleteApigee components within a specific scope, useapigeectl with the flags for the scope that includes those components:

  • --all-envs: all environment-scope components in all the environments under the organization named in the override config file
  • --datastore: Cassandra.
  • --envenv-name: the environment-scope components: Runtime, Synchronizer, and UDCA
  • --org: the organization-scope components: Apigee Connect Agent, Mart, and Watcher
  • --settings virtualhosts:virtualhost settings only
  • --telemetry: Logger and Metrics

For example:

apigeectl delete -fyour_overrides_file.yaml --org --envenv-name

To deleteonly the Apigee components from the cluster, use this command:

apigeectl delete -fyour_overrides_file.yaml

Use the following commands to deletethe entire Apigee hybrid installation except Anthos Service Mesh (Istio) and cert-manager from your cluster:

  1. Runapigeectl delete with the default scope:
    apigeectl delete -fyour_overrides_file.yaml
  2. Verify that the Apigee hybrid components were deleted:
    kubectl -n apigee get apigeedatastore,apigeeredis,apigeetelemetry,org,env,arc

    Your output should be empty

  3. Runapigeectl delete again with--all:
    apigeectl delete --all -fyour_overrides_file.yaml

For more information about theapigeectl command, seeapigeectl.

Use the following command to remove cert-manager:

kubectl -n cert-manager delete secret apigee-ca
If you have a multi-region installation, and you want to install Apigee hybrid again on the same region, you need to follow the instructions for copying theapigee-ca secret inMulti-region deployment on GKE and GKE on-prem.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.