How to Configure Helm Charts in the Add-ons Interface

Last updated: September 19, 2025

When deploying Helm charts through the add-ons interface, it's important to use the correct configuration format to avoid initialization issues. Here's how to properly configure a Helm chart deployment:

Required Configuration

When setting up a Helm chart, you'll need to provide:

  • Helm Repository URL - The complete URL to the Helm repository

  • Chart Name - The name of the specific chart you want to deploy (not the repository name)

  • Chart Version - The version of the chart you wish to deploy

  • Values - Your YAML configuration for the chart

Common Issues

If your Helm chart deployment is stuck on "Initializing...", check that you're using:

  • The correct chart name (do not include the repository name prefix)

  • A valid repository URL (use the actual Helm repository URL, not package listing URLs from sites like Artifact Hub)

  • Proper YAML formatting in the values section

Important: When specifying the chart name, use only the actual chart name without the repository prefix. For example, if the chart is typically referenced as haproxytech/haproxy in CLI commands, you should only enter haproxy in the chart name field.

Example: If you find a chart on Artifact Hub at https://artifacthub.io/packages/helm/infracloud-charts/chromadb, the correct repository URL would be https://infracloudio.github.io/charts (found in the chart's repository information), not the Artifact Hub package URL.

Troubleshooting

If your deployment is stuck:

  1. Delete the existing add-on

  2. Create a new add-on with the correct configuration

  3. Verify the chart name is correctly specified without the repository prefix

  4. Check that the repository URL is accessible