Repository Management

Learn how to create, manage, and organize your Helm chart repositories effectively.

Repository Types

Private

Secure repositories accessible only to authorized users.

  • Access control
  • Team collaboration
  • Private chart hosting
  • Secure distribution

Public

Open repositories available to everyone.

  • Public visibility
  • Community sharing
  • Free distribution
  • Public discovery

Common Commands

Create Repository

Create a new Helm chart repository

helmbay repo create my-charts --description "My Helm Charts"

List Repositories

View all your repositories

helmbay repo list

Add to Helm

Add repository to local Helm client

helm repo add my-charts https://charts.helmbay.com/my-charts

Push Chart

Upload a chart to repository

helm push mychart-0.1.0.tgz oci://charts.helmbay.com/my-charts

Best Practices

Naming Conventions

Use clear, descriptive names for repositories and maintain consistency across your organization.

Example: team-name-service-type (e.g., frontend-web-apps)

Version Control

Always version your charts properly and maintain a clear versioning strategy.

Example: Follow semantic versioning (e.g., 1.0.0, 1.0.1)

Documentation

Include comprehensive README files and maintain up-to-date documentation for each chart.

Example: Document dependencies, configuration options, and usage examples

Access Control

Implement proper access controls and regularly review permissions.

Example: Use team-based access control for better management

Next Steps

Learn how to manage access control and team collaboration for your repositories.

Access Control Guide →