This project is in the process of being donated to the CNCF and is not affiliated with the Kubernetes project.
Documentation
Operations
Uninstall

Uninstall

If you no longer need your kgateway environment, you can uninstall the control plane and all gateway proxies. You can also optionally remove related components such as Prometheus and sample apps.

Uninstall kgateway

Remove the kgateway control plane and gateway proxies.

ℹ️
Did you use Argo CD to install kgateway? Skip to the Argo CD steps.

  1. Get all HTTP routes in your environment.

    kubectl get httproutes -A

  2. Remove each HTTP route.

    kubectl delete -n <namespace> httproute <httproute-name>

  3. Get all reference grants in your environment.

    kubectl get referencegrants -A

  4. Remove each reference grant.

    kubectl delete -n <namespace> referencegrant <referencegrant-name>

  5. Get all gateways in your environment that are configured by the kgateway gateway class.

    kubectl get gateways -A | grep kgateway

  6. Remove each gateway.

    kubectl delete -n <namespace> gateway <gateway-name>

  7. Uninstall kgateway.

    1. Uninstall the kgateway release.

      helm uninstall kgateway -n kgateway-system

    2. Remove the kgateway-system namespace.

      kubectl delete namespace kgateway-system

  8. Remove the Kubernetes Gateway API CRDs.

    kubectl delete -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/standard-install.yaml

Uninstall with ArgoCD

For ArgoCD installations, use the following steps to clean up your environment.

  1. Port-forward the Argo CD server on port 9999.

    kubectl port-forward svc/argocd-server -n argocd 9999:443

  2. Open the Argo CD UI.

  3. Log in with the admin username and kgateway password.

  4. Find the application that you want to delete and click x.

  5. Select Foreground and click Ok.

  6. Verify that the pods were removed from the kgateway-system namespace.

    kubectl get pods -n kgateway-system

    Example output:

    No resources found in kgateway-systemnamespace.

  1. Port-forward the Argo CD server on port 9999.

    kubectl port-forward svc/argocd-server -n argocd 9999:443

  2. Log in to the Argo CD UI.

    argocd login localhost:9999 --username admin --password kgateway --insecure

  3. Delete the application.

    argocd app delete kgateway-oss-helm --cascade --server localhost:9999 --insecure

    Example output:

    Are you sure you want to delete 'kgateway-oss-helm' and all its resources? [y/n] y
application 'kgateway-oss-helm' deleted

  4. Verify that the pods were removed from the kgateway-system namespace.

    kubectl get pods -n kgateway-system

    Example output:

    No resources found in kgateway-system namespace.

Uninstall optional components

Remove any optional components that you no longer need, such as sample apps.

  1. If you no longer need the Prometheus stack to monitor resources in your cluster, uninstall the release and delete the namespace.

    helm uninstall kube-prometheus-stack -n monitoring
kubectl delete namespace monitoring

  2. Remove the httpbin sample app.

    kubectl delete -f https://raw.githubusercontent.com/kgateway-dev/kgateway/refs/heads/main/examples/httpbin.yaml

  3. Remove the Petstore sample app.

    kubectl delete -f https://raw.githubusercontent.com/kgateway-dev/kgateway.dev/main/assets/docs/examples/petstore.yaml
Debug your setup