Build a Repo Index with helm repo index
Generating the index.yaml a repository needs.
Build a Repo Index with helm repo index is a free Helm Academy lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Helm Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
A Repo Is Just Files
A classic Helm repository is nothing fancy: a folder of .tgz archives plus one special catalog file. That catalog is the index.yaml.
Why index.yaml Matters
Helm never lists a folder remotely. It downloads index.yaml to learn which charts and versions exist and where to fetch each one.
Generate It With One Command
Point helm repo index at the folder holding your packaged charts and it scans every .tgz to build the catalog automatically.
helm repo index ./distInside the Index
The generated index.yaml lists each chart name, version, digest, and a download URL. Helm uses these entries to resolve installs.
entries:
mychart:
- version: 0.2.0
urls:
- mychart-0.2.0.tgzSet the Public URL
The --url flag rewrites each entry's download link to the address where the archives will actually be served, not a local path.
helm repo index ./dist --url https://charts.example.comEach Chart Has a Digest
The index records a SHA-256 digest for every archive. Helm verifies it on download so a corrupted or swapped file is caught.
digest: sha256:9f86d08...Merging New Charts In
Regenerating from scratch can drop history. The --merge flag folds new archives into an existing index, preserving older version entries.
helm repo index ./dist --merge ./dist/index.yamlOrder of Operations
Always package first, then index. The index only sees archives already present, so a fresh .tgz must exist before indexing runs.
helm package ./mychart -d ./dist
helm repo index ./dist --url https://charts.example.comMultiple Versions Coexist
One chart name can hold many version entries. Keeping old .tgz files lets users install or roll back to any published release.
Index Lives Beside Archives
Place the finished index.yaml in the same directory you will serve. Helm fetches it from the repo root, then resolves chart URLs relative to it.
Regenerate on Every Publish
The index is a snapshot, not live. Each time you add a chart you must rebuild or merge the index.yaml or clients will not see it.
Quick Check
You generated an index but downloads point at local paths. Which flag fixes the URLs?
Recap: Building the Index
You ran helm repo index to catalog your archives, set the public URL, and used --merge to keep old versions. The repo now has its map. 🗂️
Frequently asked questions
Is the “Build a Repo Index with helm repo index” lesson free?
Yes — the full text of “Build a Repo Index with helm repo index” is free to read here on the web, and the Helm Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Helm Academy course, upgrade to CoddyKit PRO.
What will I learn in “Build a Repo Index with helm repo index”?
Generating the index.yaml a repository needs. You practise Helm Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Helm Academy?
No prior experience is required. Helm Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Build a Repo Index with helm repo index” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Helm Academy lesson?
Yes. Every Helm Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Bundle a Release Archive with helm package
- Build a Repo Index with helm repo index
- Hosting a Chart Repository
- Pushing Charts to an OCI Registry