Development version

This documentation is for a Forgejo version which is not yet released.

To read the documentation for the released version of Forgejo, navigate to the latest version.

Helm Chart Registry

Publish Helm charts for your user or organization.

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://forgejo.example.com/api/packages/{owner}/helm/api/charts

or with the helm cm-push plugin:

helm repo add  --username {username} --password {password} {repo} https://forgejo.example.com/api/packages/{owner}/helm
helm cm-push ./{chart_file}.tgz {repo}
ParameterDescription
usernameYour Forgejo username.
passwordYour Forgejo password. If you are using 2FA or OAuth use a personal access token instead of the password.
repoThe name for the repository.
chart_fileThe Helm Chart archive.
ownerThe owner of the package.

Install a package

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

helm repo add  --username {username} --password {password} {repo} https://forgejo.example.com/api/packages/{owner}/helm
helm repo update
helm install {name} {repo}/{chart}
ParameterDescription
usernameYour Forgejo username.
passwordYour Forgejo password or a personal access token.
repoThe name for the repository.
ownerThe owner of the package.
nameThe local name.
chartThe name Helm Chart.