Master Helm Repository Management: Add, Update, Search, Pull, and Push Charts

Overview

Helm repositories are simple HTTP servers that host packaged Helm charts (.tgz files) together with an index.yaml file that lists chart metadata such as name, version, and description. Helm clients query the index to discover available charts.

Official documentation: https://helm.sh/zh/docs/topics/chart_repository/

Public repository index: https://artifacthub.io/

Common Repository Types

Official repository (archived; use Artifact Hub to discover community charts)

Community repositories such as Bitnami, Jetstack, etc.

Private repositories for internal, proprietary charts

Typical Public Helm Repositories

Bitnami – https://charts.bitnami.com/bitnami Grafana – https://grafana.github.io/helm-charts Prometheus Community – https://prometheus-community.github.io/helm-charts Harbor – https://helm.goharbor.io MinIO Operator –

https://operator.min.io

Helm Repository Management Commands

Add a Repository

helm repo add [NAME] [URL]

Example:

helm repo add prometheus https://prometheus-community.github.io/helm-charts

Update Repository Index

helm repo update

This fetches the latest index.yaml from all configured repositories.

List Repositories

helm repo list

Shows each repository name and its URL.

Remove a Repository

helm repo remove [NAME]

Example:

helm repo remove grafana

Search Charts

helm search repo [KEYWORD]

Performs fuzzy matching across all configured repositories.

Show Chart Versions

helm search repo [CHART] --versions

Example:

helm search repo prometheus/kube-prometheus-stack --versions

Pull a Chart

helm pull [CHART] --version [VERSION] --untar --destination [DIR] --repo [REPO_URL]

Example:

helm pull prometheus/kube-prometheus-stack --version 72.9.0 --untar --destination ./charts

Private Repository Commands

Create Repository Index

helm repo index [DIR] --url [REPO_URL]

Generates an index.yaml for a local directory of chart packages, suitable for serving as a private Helm repository.

Push a Chart

helm push [CHART_PATH] [REPO_NAME]

Uploads a packaged chart to a Helm repository that supports the helm push plugin (e.g., ChartMuseum, OCI registries).