Helm Charts

Stout serves a native Helm chart repository with automatic index.yaml generation, per-owner namespacing, and ETag caching.

Configure Your Client

Add your Stout instance as a Helm repo:

# Add a repo for an owner's charts
helm repo add myorg https://registry.stout.io/helm/myorg

# Local development
helm repo add myorg http://localhost:7888/helm/myorg

# Update the index
helm repo update

Install a Chart

Install a chart from the repo:

helm install my-release myorg/my-chart --version 1.2.0

Publish a Chart

Stout builds charts from source. Submit a chart for building via the API:

curl -X POST https://registry.stout.io/api/v1/builds \
  -H "Authorization: Bearer $STOUT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "helm",
    "repo": "https://github.com/myorg/my-chart",
    "version": "1.2.0"
  }'

Authentication

For private chart repos, pass credentials to Helm:

helm repo add myorg https://registry.stout.io/helm/myorg \
  --username token \
  --password $STOUT_TOKEN

Endpoints