Guides

Uninstall Telark

Remove the Telark release, and optionally every Telark resource and volume.

helm uninstall removes the services and keeps your data, so a reinstall picks up where you left off. A full teardown is a separate step.

1. Prepare

  1. Cancel active protection plans, so their Kyverno policies are removed.
  2. Wait for any rollback in progress to finish.
  3. Before a full teardown, back up what you want to keep. See Back up Telark.

2. Uninstall the release

helm uninstall telark -n telark

This removes every Telark service and the bundled Kyverno with its webhooks. Its pre-delete hooks also stop the auth service and clear the telark.io/*-cleanup finalizers on users, groups and access roles; a reinstall that keeps the data restores them within a minute. The hooks run the app.image.kubectl image, so air-gapped clusters must mirror it. These stay:

  • The CRDs and every Telark custom resource (helm.sh/resource-policy: keep).
  • The service-token, NATS, Redis and OIDC trust Secrets.
  • The exporter's snapshot and report volumes, the Redis and NATS volumes, and the Ollama model volume.

Stop here if you plan to reinstall. A reinstall picks up the exporter's volumes, copied to new ones when you name a different class. After a class change, reinstall with the same storage settings, or the original volumes come back as they were at the change (Exporter storage).

3. Full teardown

Run these after step 2, in this order. Deleting the namespace before helm uninstall leaves the release's cluster-wide objects behind, and the namespace hangs in Terminating (Troubleshooting).

# 1. Delete the CRDs, and with them every Telark custom resource
kubectl delete crd -l app.kubernetes.io/part-of=telark

# 2. Only if you run your own Kyverno (kyverno.enabled=false): leftover plan policies
kubectl delete namespacedvalidatingpolicies.policies.kyverno.io -A -l telark.io/protection-plan

# 3. The remaining volumes and Secrets
kubectl delete namespace telark

4. Check that nothing is left

kubectl get crd -l app.kubernetes.io/part-of=telark
kubectl get namespace telark

Both commands should report that nothing was found.

Uninstalled with --no-hooks

The hooks did not run, so the bundled Kyverno's webhooks stay behind and keep intercepting API writes. Delete them:

kubectl delete validatingwebhookconfigurations,mutatingwebhookconfigurations -l webhook.kyverno.io/managed-by=kyverno

The cleanup finalizers also stay, so deleting the CRDs or the namespace hangs in Terminating. Clear them; the pending deletions then complete on their own:

kubectl get users.telark.io,groups.telark.io,accessroles.telark.io -n telark -o name |
  xargs -r -P 16 -I{} kubectl patch -n telark {} --type merge -p '{"metadata":{"finalizers":null}}'