forgejo/docs/content/doc/packages/helm.en-us.md

date	title	slug	draft	toc	menu
2022-04-14T00:00:00+00:00	Helm Chart Registry	packages/helm	false	false	sidebar parent name weight identifier packages Helm 50 helm

Helm Chart Registry

Publish Helm charts for your user or organization.

Table of Contents

{{< toc >}}

Requirements

To work with the Helm Chart registry use a simple HTTP client like curl or the helm cm-push plugin.

Publish a package

Publish a package by running the following command:

curl --user {username}:{password} -X POST --upload-file ./{chart_file}.tgz https://gitea.example.com/api/packages/{owner}/helm/api/charts

or with the helm cm-push plugin:

helm repo add  --username {username} --password {password} {repo} https://gitea.example.com/api/packages/{owner}/helm
helm cm-push ./{chart_file}.tgz {repo}

Parameter	Description
username	Your Gitea username.
password	Your Gitea password. If you are using 2FA or OAuth use a [personal access token]({{< relref "doc/developers/api-usage.en-us.md#authentication" >}}) instead of the password.
repo	The name for the repository.
chart_file	The Helm Chart archive.
owner	The owner of the package.

Install a package

To install a Helm char from the registry, execute the following command:

helm repo add  --username {username} --password {password} {repo} https://gitea.example.com/api/packages/{owner}/helm
helm repo update
helm install {name} {repo}/{chart}

Parameter	Description
username	Your Gitea username.
password	Your Gitea password or a personal access token.
repo	The name for the repository.
owner	The owner of the package.
name	The local name.
chart	The name Helm Chart.