# Error: UPGRADE FAILED: incompatible versions client[v3.10.0] server[v3.8.0]

- **ID:** `cicd/helm-upgrade-failed-incompatible-versions`
- **Domain:** cicd
- **Category:** config_error
- **Error Code:** `HELM_VERSION_MISMATCH`
- **Verification:** ai_generated
- **Fix Rate:** 79%

## Root Cause

Helm client and Tiller/server versions are mismatched, or in Helm v3, the installed chart version is not compatible with the cluster's Helm SDK version due to API changes.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Helm v3.8.0 | active | — | — |
| Helm v3.10.0 | active | — | — |
| Helm v3.12.0 | active | — | — |
| Kubernetes 1.25 | active | — | — |

## Workarounds

1. **Upgrade Helm client to match server: `curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash -s -- --version v3.8.0`** (85% success)
   ```
   Upgrade Helm client to match server: `curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash -s -- --version v3.8.0`
   ```
2. **Use helm template to render locally and apply with kubectl, bypassing Helm server: `helm template release-name chart/ > manifest.yaml && kubectl apply -f manifest.yaml`** (90% success)
   ```
   Use helm template to render locally and apply with kubectl, bypassing Helm server: `helm template release-name chart/ > manifest.yaml && kubectl apply -f manifest.yaml`
   ```
3. **In CI/CD, pin Helm version in setup step: `uses: azure/setup-helm@v3 with helm-version: '3.8.0'`** (88% success)
   ```
   In CI/CD, pin Helm version in setup step: `uses: azure/setup-helm@v3 with helm-version: '3.8.0'`
   ```

## Dead Ends

- **** — --force only reapplies resources; does not fix version incompatibility; may cause resource conflicts. (65% fail)
- **** — Cluster downgrade is risky and may break other services; not practical for production. (80% fail)
- **** — Reinstall doesn't change the server version; the cluster's Helm SDK is embedded in the tiller or in-cluster agent. (50% fail)