Skip to main content

remove

Remove application reference from the KOTS Admin Console.

You can use the kots remove command to remove one or more installed applications from the Admin Console. By default, the deployed application is not removed from the cluster. Only the reference for the application is removed from the Admin Console. To completely remove the application and delete its resources from the cluster, use the --undeploy flag.

Usage

kubectl kots remove [app-slug] -n [namespace]
  • [app-slug] is the slug of the installed application to be removed (required)
  • Provide [flags] according to the table below

This command supports all global flags and also:

FlagTypeDescription
--forcebool

Removes the reference even if the application has already been deployed.

--undeploybool

Un-deploys the application by deleting all its resources from the cluster. When --undeploy is set, the --force flag is set automatically.

Note: --undeploy can remove application resources only from the namespace where KOTS is installed and from any namespaces provided in the additionalNamespaces field in the Application custom resource.

The following describes how --undeploy removes application resources:

  • For applications deployed with kubectl apply (including standalone manifest files and Helm charts deployed with Replicated Helm), --undeploy identifies and removes resources based on a kots.io/app-slug: <app_slug> annotation that is applied to all application resources during deployment.
  • For Helm chart applications deployed with HelmChart custom resources with apiVersion: kots.io/v1beta2 or apiVersion: kots.io/v1beta1 and useHelmInstall: true, --undeploy runs helm uninstall.
-nstring

The namespace where the target application is deployed. Use default for the default namespace.

Example

kubectl kots remove sentry -n default