CONFIGURATION

Configuration Overview

Kubeadapt Helm chart installation, platform support, prerequisites, and upgrade instructions.

The kubeadapt Helm chart deploys a single-pod agent into your Kubernetes cluster. The agent collects cluster metrics and sends them to Kubeadapt Cloud for cost analysis and rightsizing recommendations.

Platform Support

PlatformStatusNotes
Amazon EKSSupportedTested on 1.24 through 1.35
Azure AKSSupportedTested on 1.24 through 1.35
Google GKESupportedStandard and Autopilot modes
Red Hat OpenShiftSupported4.x and later
On-premise / self-hostedSupportedkubeadm, kops, Rancher, k3s, RKE2

Prerequisites

  • Kubernetes 1.24 or later
  • Helm 3.0 or later
  • metrics-server running in the cluster. Most managed providers include it by default. The agent reads live CPU and memory usage from the metrics.k8s.io API. Without it, the platform cannot generate rightsizing recommendations.

Installation

bash
helm repo add kubeadapt https://kubeadapt.github.io/kubeadapt-helm helm repo update
bash
helm install kubeadapt kubeadapt/kubeadapt \ --namespace kubeadapt \ --create-namespace \ --set agent.config.token="<your-token>"

Get a token from app.kubeadapt.io under Clusters > Add Cluster.

Tip

The dashboard generates the full install command with your token pre-filled. Copy and run it directly.

OCI Registry

You can also pull from the OCI registry instead of the Helm repo:

bash
helm install kubeadapt oci://ghcr.io/kubeadapt/kubeadapt-helm/kubeadapt \ --namespace kubeadapt \ --create-namespace \ --set agent.config.token="<your-token>"

Upgrading

bash
helm repo update helm upgrade kubeadapt kubeadapt/kubeadapt \ --namespace kubeadapt \ --reset-then-reuse-values

Or enable Auto-Upgrade to handle this automatically.

Uninstalling

bash
helm uninstall kubeadapt --namespace kubeadapt
Note

Uninstalling removes all Kubeadapt resources from the cluster. Historical data in the Kubeadapt dashboard is retained.

Chart Signing

All chart packages are GPG-signed. The public key is published at the Helm repo root.

  • Fingerprint: 3C8109B607AD3E119B7033D8948AD9EDA6BD626E
  • Key ID: 948AD9EDA6BD626E

Verify a downloaded package:

bash
helm verify kubeadapt-0.18.5.tgz --keyring pubkeys.gpg