Uninstall

Uninstalling Imageless Kubernetes from any cluster

This guide describes how to remove Imageless Kubernetes from a cluster.

First, remove the RuntimeClass with:

kubectl delete runtimeclass flox

Then follow the installation-method specific guidance below.

Amazon EKS

If a separate node group was used for Imageless Kubernetes, removing that node group and the RuntimeClass is all that is required to uninstall.

Terraform

If Terraform was used to add a node group to an existing cluster:

• Remove the eks_managed_node_group resource from your configuration
• Apply the updated configuration

eksctl

If eksctl was used, remove the node group with:

eksctl delete nodegroup -f nodegroup.yaml

where nodegroup.yaml is the file that was used to create it.

Alternatively, remove the node group directly from the AWS management console.

Self-managed

First, remove the Flox runtime from the containerd configuration on each node.

The installer used in the installation instructions makes a backup of the original configuration in /etc/containerd/config.toml.bak.xx where xx is an arbitrary number.

Restore the backup with:

sudo mv /etc/containerd/config.toml.bak.xx /etc/containerd/config.toml &&
sudo systemctl restart containerd

Then remove the shim from each node with:

sudo rm /usr/local/bin/containerd-shim-flox-v2

And finally, uninstall Flox from each node by following the instructions from the Uninstall Flox page.