Helm Chart

Preflight Check

If you'd like to verify your environment's compatibility, use the following script:

curl -sSL https://github.com/qpoint-io/preflight/releases/latest/download/preflight.sh | sudo bash

Prerequisites

• Kubernetes cluster on a Linux Host with supported Kernel (5.10+)

• Helm

• Kubectl

• A valid registration token from app.qpoint.io (Settings -> Installation)

Install Qpoint Helm Repo

First, add the Qpoint Helm Repo:

helm repo add qpoint https://helm.qpoint.io/

helm repo update

helm search repo qpoint/qtap --versions

helm show values qpoint/qtap

Deploy Qtap

Direct

helm install qtap qpoint/qtap \
  -n qpoint \
  --create-namespace \
  --set logLevel=warn \
  --set registrationToken=$TOKEN \
  --set extraArgs="{--tags=Environment:Production\,Cluster:EKS-1}"

Tags are optional (--tags flag) but useful for filtering in Qplane dashboards. When using --set, escape commas with \,. See Organizations & Environments for when to use tags vs installations.

Kubernetes Secrets

Verifying the Deployment

To verify that Qtap is running:

kubectl get pods -n qpoint

You should see a pod named qtap-xxxx in the Running state.

Uninstalling Qtap

To uninstall Qtap:

helm uninstall qtap -n qpoint

Important Notes

1. The Qtap pod requires privileged access for eBPF operations. Ensure your cluster's security policies allow this.

2. To set a specific version, use --set image.tag="v0.9.7"

3. For cloud-connected mode, keep your registration token secure and do not share it in public repositories.

4. For local mode, ensure your configuration is correctly formatted and contains all necessary settings.

5. The default configuration mounts the host's /sys directory. Ensure this is allowed in your cluster.

6. You may need to adjust resource requests and limits based on your cluster's capacity and Qtap's requirements.

7. When using secret management, ensure proper RBAC permissions are in place for accessing the secret.