Skip to content

Automated Dependency Updates for Helmv3

Renovate supports updating Helmv3 dependencies.

File Matching

By default, Renovate will check any files matching the following regular expression: (^|/)Chart\.yaml$.

For details on how to extend a manager's fileMatch value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: docker, helm.

Additional Information

Renovate supports updating Helm Chart references within requirements.yaml (Helm v2) and Chart.yaml (Helm v3) files.

The helmv3 manager defines this default registryAlias:

{
  "registryAliases": {
    "stable": "https://charts.helm.sh/stable"
  }
}

If your Helm charts make use of repository aliases then you will need to configure an registryAliases object in your config to tell Renovate where to look for them. Be aware that alias values must be properly formatted URIs.

If you need to change the versioning format, read the versioning documentation to learn more.

Private repositories and registries

To use private sources of Helm charts, you must set the password and username you use to authenticate to the private source. For this you use a custom hostRules array.

OCI registries

{
  hostRules: [
    {
      // global login
      matchHost: 'registry.gitlab.com',
      hostType: 'docker',
      username: '<some-username>',
      password: '<some-password>',
    },
    {
      // for repository string oci://registry.gitlab.com/user/oci-helm-test
      matchHost: 'https://registry.gitlab.com/user/oci-helm-test',
      hostType: 'docker',
      username: '<some-username>',
      password: '<some-password>',
    },
  ],
}

Helm repository

{
  hostRules: [
    {
      // global login
      matchHost: 'gitlab.com',
      username: '<some-username>',
      password: '<some-password>',
    },
    {
      // specific repository
      matchHost: 'https://gitlab.com/api/v4/projects/xxxxxxx/packages/helm/stable',
      username: '<some-username>',
      password: '<some-password>',
    },
  ],
}