~/DOCS/

Uninstalling

To uninstall Architect without disrupting running workloads, follow these steps in order. Failure to update workloads before uninstalling will cause pod errors.

1. Prepare Workloads

Before running the uninstall command, update your workload configurations to ensure they no longer depend on the Architect runtime:

  • Remove runtimeClassName from all active workloads. If you uninstall Architect while runtimeClassName is still set, all managed pods will immediately enter an Error state.
  • Remove annotations (optional): delete any architect.loopholelabs.io/* annotations to keep your manifests clean.

2. Uninstall the Helm Release

Once your workloads are updated, remove the Architect release:

helm uninstall -n architect architect

3. Clean Up Node Labels

Remove any remaining Architect-specific labels from your cluster nodes:

kubectl label nodes <node-name> architect.loopholelabs.io/node-
kubectl label nodes <node-name> architect.loopholelabs.io/critical-node-