Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Container Registry
  • Getting started
    • All guides
    • Installing and configuring Docker
    • Authentication in Container Registry
      • Getting information about existing Helm charts
      • Pushing a Helm chart to a registry
      • Pulling a Helm chart from a registry
      • Deleting a Helm chart from a registry
    • Scanning Docker images for vulnerabilities
    • Creating a trigger for a registry
  • Yandex Container Solution
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Troubleshooting
  • FAQ
  1. Step-by-step guides
  2. Managing a Helm chart
  3. Pushing a Helm chart to a registry

Pushing a Helm chart to a registry

Written by
Yandex Cloud
Improved by
Danila N.
Updated at April 22, 2025

You can push Helm Charts to a Container Registry repository. Container Registry stores Helm charts the same way as conventional Docker Images.

Note

If you are using a Helm version lower than 3.7.1, re-upload the charts to the Container Registry repository when upgrading to a newer version.

To push a Helm chart:

CLI
  1. Install the Helm client version 3.8.0 or higher.

    Note

    When installing Helm, environment variables are not updated automatically. To run helm commands, use the installation directory or manually add Helm to environment variables.

  2. If you are using a Helm version below 3.8.0, enable Open Container Initiative support in the Helm client:

    export HELM_EXPERIMENTAL_OCI=1
    
  3. Authenticate your Helm client in the Container Registry registry using one of the available methods.

    • With an OAuth token:

      1. If you do not have an OAuth token yet, get one by following this link.

      2. Run this command:

        helm registry login cr.yandex -u oauth
        Password: <OAuth_token>
        
    • Using an IAM token:

      1. Get an IAM token.

      2. Run this command:

        helm registry login cr.yandex -u iam
        Password: <IAM_token>
        

    Result:

    Login succeeded
    
  4. Create a Helm chart:

    helm create <Helm_chart_name>
    

    The name must meet the following requirements:

    • It must be from 2 to 63 characters long.
    • It may contain lowercase Latin letters, numbers, and hyphens.
    • It must start with a letter and cannot end with a hyphen.

    Result:

    Creating <Helm_chart_name>
    
  5. Build a Helm chart to upload:

    helm package <Helm_chart_name>/. --version <Helm_chart_version>
    

    Result:

    Successfully packaged chart and saved it to: <path>/<Helm_chart_name>-<version>.tgz
    
  6. Push the Helm chart to Container Registry:

    helm push <Helm_chart_name>-<version>.tgz oci://cr.yandex/<registry_ID>
    

    Result:

    Pushed: cr.yandex/crp3h07fgv9b********/<Helm_chart_name>:<version>
    Digest: <SHA256...>
    

ExamplesExamples

CLI
  1. Create a Helm chart:

    helm create my-chart
    

    Result:

    Creating my-chart
    
  2. Build a Helm chart to upload:

    helm package my-chart/. --version 3.11.2
    

    Result:

    Successfully packaged chart and saved it to: C:/my-chart-3.11.2.tgz
    
  3. Push the Helm chart to Container Registry:

    helm push my-chart-3.11.2.tgz oci://cr.yandex/<registry_ID>
    

    Result:

    Pushed: cr.yandex/crp3h07fgv9b********/my-chart:3.11.2
    Digest: sha256:dc44a4e8b686b043b8a88f77ef9dcb998116fab422e8c892a2370da0********
    

Was the article helpful?

Previous
Getting information about existing Helm charts
Next
Pulling a Helm chart from a registry
Yandex project
© 2025 Yandex.Cloud LLC