> For the complete documentation index, see [llms.txt](https://docs.qpoint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qpoint.io/getting-started/qtap/installation/helm-chart.md).

# Helm Chart

## Preflight Check

If you'd like to verify your environment's compatibility, use the [following script](https://github.com/qpoint-io/preflight/tree/main):

{% code overflow="wrap" %}

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

{% endcode %}

## Prerequisites

* Kubernetes cluster on a Linux Host with supported Kernel (5.10+)
* `Helm`
* `Kubectl`
* [Qtap YAML config file](/getting-started/qtap/configuration.md)

## Install Qpoint Helm Repo

First, add the Qpoint Helm Repo:

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

```bash
helm repo update
```

```bash
helm search repo qpoint/qtap --versions
```

```bash
helm show values qpoint/qtap
```

## Deploy Qtap

You'll need to provide your Qtap configuration using a YAML file. First, [create your configuration file](/getting-started/qtap/configuration.md) `qtap-config.yaml` and supply it via your helm command:

```bash
helm install qtap qpoint/qtap \
  -n qpoint \
  --create-namespace \
  --set logLevel=warn \
  --set-file config=./qtap-config.yaml
```

## Verifying the Deployment

To verify that Qtap is running:

```bash
kubectl get pods -n qpoint
```

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

## Uninstalling Qtap

To uninstall Qtap:

```bash
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.17.1"`
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.