Skip to main content
Adding your own registry to Ankra enables you and your team to distribute Helm charts as add-on components that can be deployed onto a cluster as part of a stack.

Create your own registry with GitHub

Use any OCI Helm registry (GHCR, Harbor, JFrog Artifactory, AWS ECR, Google Artifact Registry, etc.) with Ankra. This guide focuses on GitHub Container Registry (GHCR) as a free and accessible example.
GitHub Container Registry (GHCR) provides a free and reliable way to host your own Helm charts.

Prerequisites

Before you begin, ensure you have:
  • A GitHub account
  • Git installed on your machine
  • Helm CLI installed (Installation guide)
  • A GitHub Personal Access Token with write:packages permission
To create a Personal Access Token: Go to GitHub Settings > Developer settings > Personal access tokens > Generate new token, and select the write:packages scope.

Step 1: Set Up Your Repository

Create a new GitHub repository to host your Helm charts:
  1. Go to GitHub and create a new repository (e.g., my-helm-charts)
  2. Clone the repository locally:

Step 2: Create Your Helm Chart

Generate a new Helm chart or prepare an existing one:
This creates a basic chart structure:

Step 3: Configure Your Chart

Edit the Chart.yaml file to include proper metadata:

Step 4: Package Your Chart

Package your Helm chart into a .tgz file:
This creates a file like my-sparkly-app-1.0.0.tgz.

Step 5: Login to GHCR

Authenticate with GitHub Container Registry using your Personal Access Token:
Replace $GITHUB_TOKEN with your actual token and YOUR_USERNAME with your GitHub username.

Step 6: Push Your Chart

Push your packaged chart to GHCR:

Step 7: Verify your registry

After pushing, your chart will be available at:
You can verify the upload by checking your GitHub repository’s “Packages” tab.

Step 8: Add your registry to Ankra

Now that your chart is published, add your GHCR registry to Ankra. You need a role that may manage Helm registries, and a second GitHub token with the read:packages scope for Ankra to read the chart with. The address oci://ghcr.io/YOUR_USERNAME/helm-charts has two path segments after the host. The portal’s Connect a registry dialog connects a host plus one project (oci://ghcr.io/YOUR_USERNAME), so add this address with the CLI.
1

Store the registry login

Open Integrations & alerts → Credentials → Add credential → Helm registry. Enter a Name (such as ghcr-auth), your GitHub username as Username and the read:packages token as Password or access token, then select Save registry login. See Registry credentials for details.
The credential ghcr-auth is listed under Registry credentials on Build & delivery → Helm registries.
2

Add the registry

An oci:// address creates an OCI registry, and Ankra reads it right away.
3

Check that Ankra read your chart

my-sparkly-app is listed. In the portal, Build & delivery → Helm registries shows my-helm-charts with the State Up to date. If it reads Last read failed, check the token’s scope and the address, then select Sync now on the registry’s page.

Use your chart in a Stack

Open a cluster’s Stack in the stack editor, select Add → Helm add-on and search for my-sparkly-app in Find a chart. Pin the version, set its values, select Add to draft, then review and deploy the draft. The full flow is in Create and change a stack.

Next Steps

Connect a Helm registry

Connect other registry types - Harbor, Artifactory, ECR, and more.

Stacks

Compose your charts with manifests and dependencies into Stacks.