Compatibility Matrix for Cybus Helm Charts

How to choose the right Cybus Helm chart version for your Connectware version.

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 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 and upwards	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 and upwards	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.

For production environments, pin to a specific chart version. Pinning gives you reproducible deployments and prevents unintended upgrades.

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.

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

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, then install the matching chart version with the --version flag:

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

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

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

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

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.

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.