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.
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:packagespermission
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:- Go to GitHub and create a new repository (e.g.,
my-helm-charts) - Clone the repository locally:
Step 2: Create Your Helm Chart
Generate a new Helm chart or prepare an existing one:Step 3: Configure Your Chart
Edit theChart.yaml file to include proper metadata:
Step 4: Package Your Chart
Package your Helm chart into a.tgz file:
my-sparkly-app-1.0.0.tgz.
Step 5: Login to GHCR
Authenticate with GitHub Container Registry using your Personal Access Token:$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: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 theread: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
- Portal
- CLI
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.ghcr-auth is listed under Registry credentials on Build & delivery → Helm registries.2
Add the registry
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 formy-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.