Skip to main content
Version: 2.1.0

Uninstalling Litmus


To disconnect the ChaosAgent connected to the ChaosCenter, follow these steps -

  1. Remove the ChaosEngines of the respective ChaosAgent

    kubectl delete chaosengine <CHAOSENGINE_NAMEs> --all -<AGENT_NAMESPACE>

    If ChaosEngines is unable to delete successfully then the Kubernetes finalizers need to be removed manually.

  2. Login to the ChaosCenter and navigate to the ChaosAgents Tab.

  3. Click on the Disconnect icon Disconnect Icon of the respective ChaosAgent you want to disconnect.

  4. On the Modal that appears, confirm your selection by clicking Yes and the selected ChaosAgent would be disconnected from the ChaosCenter.


    The above disconnect would remove the subscriber component from ChaosAgent and thus removing the connectivity between the ChaosAgent and the ChaosCenter.

    If the ChaosAgent is not reachable it would remove only the entry from the database of the ChaosCenter

Remove the CRs#

To remove the CRs Litmus uses, use the following command:

  • To remove individual CRs
kubectl delete chaosexperiments <CHAOSEXPERIMENTS_NAMEs> -n <AGENT_NAMESPACE>kubectl delete chaosresults <CHAOSRESULTS_NAMEs> -n <AGENT_NAMESPACE>kubectl delete workflows <WORKFLOW_NAMEs> -n <AGENT_NAMESPACE>kubectl delete cronworkflows <CRONWORKFLOW_NAMEs> -n <AGENT_NAMESPACE>kubectl delete eventtrackerpolicies -n <AGENT_NAMESPACE>
  • To remove all CRs
kubectl delete chaosengine,chaosexperiments,chaosresults --all <AGENT_NAMESPACE>kubectl delete workflows cronworflows --all <AGENT_NAMESPACE>kubectl delete eventtrackerpolicies -n <AGENT_NAMESPACE>

Delete the Deployments#

To remove the respective deployments of the ChaosAgents you need to manually delete them.

kubectl delete deployment chaos-operator-ce event-tracker workflow-controller chaos-exporter -n <AGENT_NAMESPACE>

Removing Service Account, Role Bindings and Roles#

For Cluster Scope#

kubectl delete sa argo argo-chaos litmus-admin litmus-cluster-scope event-tracker-sa -n -<AGENT_NAMESPACE>kubectl delete clusterrolebindings argo-binding chaos-cluster-role-binding event-tracker-clusterole-binding litmus-admin litmus-cluster-scope subscriber-cluster-role-bindingkubectl delete clusterrole litmus-admin chaos-cluster-role subscriber-cluster-role event-tracker-cluster-role litmus-cluster-scope argo-aggregate-to-admin argo-aggregate-to-edit argo-aggregate-to-view argo-cluster-role

For Namespace Scope#

kubectl delete sa rolebindings role --all -n <NAMESPACE>

Remove the Litmus CRDs#


If the Litmus CRDs are deleted in the Cluster Scope all the respective custom resources in the individual namespaces would stop working.

To remove all the CRDs Litmus uses, use the following command:

kubectl delete -f


To remove the Self Agent Resources you need to follow the above ChaosAgent Uninstall process

To uninstall the ChaosCenter from the system, follow these steps -

Using Kubectl#

For Cluster Scope#

  • Litmus 2.1.0

    kubectl delete -f h

    To delete any specific version of the ChaosCenter, replace the above command with the below command. kubectl delete -f<VERSION>/docs/<VERSION/litmus-<VERSION>.yaml

  • Litmus Master Manifest

    kubectl delete -f

For Namespace Scope#

kubectl delete -f ${LITMUS_PORTAL_NAMESPACE}-ns-scoped-litmus-portal-manifest.yml -n ${LITMUS_PORTAL_NAMESPACE}

Using Helm#

helm uninstall litmuschaos  --namespace litmuskubectl delete ns litmus

The namespace doesn't have to be litmus necessarily, instead it should be the same namespace where Litmus ChaosCenter is installed.