How to fix Error: chart not found in Kubernetes

KubernetesBEGINNERLOWUpdated Dec 6, 2025· 109 views

Helm cannot locate the chart you are trying to install. This is usually because the chart repository is not configured or the chart name is incorrect.

Quick fix

Fixes Error: chart not found

helm repo list
  1. List configured Helm repositories
  2. Add the chart repository
  3. Update repository index
  4. Verify chart exists in repo
kubernetes — error
helm repo list
Error: chart not found

What this error means

Helm looks for charts in configured repositories or local paths. If the chart is not in any configured repo, doesn't exist locally, or the repository hasn't been updated, Helm will report that the chart cannot be found.

Typical symptoms

  • helm install/upgrade fails with "chart not found"
  • Cannot locate chart in any repository
  • Works with different chart name
  • Chart was recently added to repo but still not found
  • Local chart path does not exist
  • Repository was not added to Helm

Common causes

  1. Chart repository not added to Helm
  2. Repository list is outdated (needs helm repo update)
  3. Chart does not exist in the specified repository
  4. Typo in chart name
  5. Using absolute path instead of repo:chart format
  6. Chart name includes version that doesn't exist

How to fix "Error: chart not found"

1List configured Helm repositories

See what repos are available:

bash
helm repo list

If empty or missing your repo, add it first.

2Add the chart repository

Add the repository:

bash
helm repo add nginx-stable https://helm.nginx.com/stable
helm repo update

Then list charts:

bash
helm search repo nginx
3Update repository index

Fetch latest charts from all repos:

bash
helm repo update

Now retry your install command.

4Verify chart exists in repo

Search for the chart:

bash
helm search repo CHART_NAME
helm search repo CHART_NAME --versions

Confirm the exact spelling and version.

5Install with correct chart reference

Use the full chart reference:

bash
helm install RELEASE REPO_NAME/CHART_NAME -n NAMESPACE

Optionally specify version:

bash
helm install RELEASE REPO_NAME/CHART_NAME --version 1.2.3 -n NAMESPACE

Advanced notes

For local charts, use file:// paths: helm install RELEASE ./local-chart/. For offline environments, pre-load chart repositories. Use helm search to discover available charts: helm search hub CHART_NAME (searches ArtifactHub). Version your charts explicitly in CI/CD to avoid version mismatches. Consider using a private Helm repository (ChartMuseum, Nexus) for internal charts.

Frequently asked questions

What does "Error: chart not found" mean?
Helm looks for charts in configured repositories or local paths. If the chart is not in any configured repo, doesn't exist locally, or the repository hasn't been updated, Helm will report that the chart cannot be found.
How do I fix "Error: chart not found"?
Helm cannot locate the chart you are trying to install. This is usually because the chart repository is not configured or the chart name is incorrect.
What causes "Error: chart not found"?
Chart repository not added to Helm Repository list is outdated (needs helm repo update) Chart does not exist in the specified repository
Is the "Error: chart not found" error serious?
It is a low-severity error — more of a blocker than a risk. The steps above resolve it.

Official resources & further reading