# Error: chart requires kubeVersion: >=1.25.0-0 which is incompatible with Kubernetes v1.24.10

- **ID:** `kubernetes/helm-incompatible-capabilities`
- **Domain:** kubernetes
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 82%

## Root Cause

A Helm chart defines a minimum Kubernetes version requirement (kubeVersion) that is not met by the current cluster version, preventing installation or upgrade.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Helm 3.11 | active | — | — |
| Helm 3.12 | active | — | — |
| Helm 3.13 | active | — | — |
| Kubernetes 1.24 | active | — | — |
| Kubernetes 1.25 | active | — | — |

## Workarounds

1. **Upgrade the cluster: use kubeadm or cloud provider to upgrade nodes to a compatible version, e.g., kubectl get nodes and then upgrade to v1.25+** (80% success)
   ```
   Upgrade the cluster: use kubeadm or cloud provider to upgrade nodes to a compatible version, e.g., kubectl get nodes and then upgrade to v1.25+
   ```
2. **Find an older chart version that supports your Kubernetes version: helm search repo <chart-name> --versions and install with --version <older-version>** (85% success)
   ```
   Find an older chart version that supports your Kubernetes version: helm search repo <chart-name> --versions and install with --version <older-version>
   ```

## Dead Ends

- **Downgrading the chart to an older version manually by editing Chart.yaml** — Chart.yaml 中的 kubeVersion 是声明式的，降级版本可能不满足其他依赖 (70% fail)
- **Ignoring the error with --force flag** — Helm 的 --force 不绕过 kubeVersion 检查，只用于资源替换 (95% fail)
- **Manually deleting the kubeVersion field from Chart.yaml** — 删除字段后安装可能成功，但 Chart 可能依赖集群特性导致运行时错误 (50% fail)