> For the complete documentation index, see [llms.txt](https://docs.cybus.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cybus.io/2-4-1/cybus-helm-charts/compatibility-matrix.md).

# Compatibility Matrix for Cybus Helm Charts

Cybus Helm charts are versioned independently from Connectware itself. The chart version and the Connectware release it deploys (`appVersion`) may be different. Use the tables under [Find Your Chart Version](#find-your-chart-version) to look up the chart version that matches your Connectware version.

## Find Your Chart Version

### connectware Helm Chart

| Helm Chart Version | Connectware Version |
| ------------------ | ------------------- |
| 3.0.0              | 2.1.0 and upwards   |
| 2.4.1              | 2.4.1               |
| 2.4.0              | 2.4.0               |
| 2.3.1              | 2.3.1               |
| 2.3.0              | 2.3.0               |
| 2.1.2              | 2.1.2               |
| 2.1.1              | 2.1.1               |
| 2.1.0              | 2.1.0               |
| 2.0.6              | 2.0.6               |
| 2.0.5              | 2.0.5               |
| 2.0.4              | 2.0.4               |
| 2.0.3              | 2.0.3               |
| 2.0.2              | 2.0.2               |
| 2.0.1              | 2.0.1               |
| 2.0.0              | 2.0.0               |
| 1.10.2             | 1.10.2              |

### connectware-agent Helm Chart

| Helm Chart Version | Protocol-Mapper Version |
| ------------------ | ----------------------- |
| 3.0.0              | 2.1.0 and upwards       |
| 2.4.1              | 2.4.1                   |
| 2.4.0              | 2.4.0                   |
| 2.3.1              | 2.3.1                   |
| 2.3.0              | 2.3.0                   |
| 2.1.2              | 2.1.2                   |
| 2.1.1              | 2.1.1                   |
| 2.1.0              | 2.1.0                   |
| 2.0.6              | 2.0.6                   |
| 2.0.5              | 2.0.5                   |
| 2.0.4              | 2.0.4                   |
| 2.0.3              | 2.0.3                   |
| 2.0.2              | 2.0.2                   |
| 2.0.1              | 2.0.1                   |
| 2.0.0              | 2.0.0                   |
| 1.6.2              | 1.10.2                  |

### connectware-toolkit Helm Chart

| Helm Chart Version | Connectware Version |
| ------------------ | ------------------- |
| 1.0.0              | 1.3.0 and upwards   |

## Choosing a Version

You have two ways to select a chart version when you run `helm install` or `helm upgrade`.

{% hint style="info" %}
For production environments, pin to a specific chart version. Pinning gives you reproducible deployments and prevents unintended upgrades.
{% endhint %}

### Option A — Install the Latest Chart Version

If you do not specify a chart version, Helm installs the latest chart, which targets the latest Connectware version.

{% code lineNumbers="true" %}

```bash
helm install ${INSTALLATION_NAME} oci://repo.cybus.io/charts/connectware -f ./values.yaml -n ${NAMESPACE} --create-namespace
```

{% endcode %}

Replace `${INSTALLATION_NAME}` with the name you want to give your Connectware installation, and `${NAMESPACE}` with the Kubernetes namespace to install Connectware into.

### Option B — Use a Specific Chart Version

Look up your Connectware version under [Find Your Chart Version](#find-your-chart-version), then install the matching chart version with the `--version` flag:

{% code lineNumbers="true" %}

```bash
helm install ${INSTALLATION_NAME} oci://repo.cybus.io/charts/connectware --version ${VERSION} -f ./values.yaml -n ${NAMESPACE} --create-namespace
```

{% endcode %}

Replace `${VERSION}` with the chart version from the table.

To verify the chart version matches the Connectware version you expect:

{% code lineNumbers="true" %}

```bash
helm show chart oci://repo.cybus.io/charts/connectware --version ${VERSION} | grep appVersion
```

{% endcode %}

## Built-in Compatibility Check

Each chart validates the container image version when you run `helm install` or `helm upgrade`. If you use the official Cybus registry (`registry.cybus.io/cybus`), the chart verifies that the image tag meets or exceeds the minimum version the chart supports. If it does not, Helm exits with an error before creating any Kubernetes resources.

{% hint style="info" %}
This check only applies when container images are pulled from the Cybus registry (`registry.cybus.io/cybus`). When custom registries are used, this validation is not performed.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cybus.io/2-4-1/cybus-helm-charts/compatibility-matrix.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.