Skip to content

Container Registry

Mengi includes a private container registry at registry.mengi.cloud. Push your Docker images and Helm charts there and deploy them straight away — Mengi handles the pull credentials for you, so you don’t need an external registry account.


Get your registry credentials

On the Container Registry page, create your credentials. You’ll get:

  • Registry URL — registry.mengi.cloud
  • A username
  • A password — shown once, so copy it now
  • Your repository prefix — a short namespace unique to your account (your images live under registry.mengi.cloud/<prefix>/…)
  • Ready-to-paste docker login and helm registry login commands

You can regenerate the credentials (rotates the password, invalidating the old one) or delete them.


Push an image

  1. Log in with the command shown on the page:

    Terminal window
    docker login registry.mengi.cloud
    # username + password from the dashboard
  2. Tag your image under your prefix and push it:

    Terminal window
    docker tag my-app registry.mengi.cloud/<prefix>/my-app:1.0.0
    docker push registry.mengi.cloud/<prefix>/my-app:1.0.0

Push a Helm chart

The registry is an OCI registry, so it stores Helm charts too. Log in with the command shown on the page and push a packaged chart under your prefix:

Terminal window
helm registry login registry.mengi.cloud
# username + password from the dashboard
helm package ./my-chart # produces my-chart-0.1.0.tgz
helm push my-chart-0.1.0.tgz oci://registry.mengi.cloud/<prefix>/charts

The chart is then available at oci://registry.mengi.cloud/<prefix>/charts/my-chart and shows up on the Container Registry page with a Helm chart badge and its versions.


Deploy a pushed image

When you create a deployment, use your image’s full reference as the Docker image:

registry.mengi.cloud/<prefix>/my-app:1.0.0

Because it’s your own registry, Mengi pulls the private image automatically — there are no separate pull credentials to configure on the deployment.


Deploy a pushed Helm chart

When you create a deployment, choose Helm Chart and either browse your registry charts to pick a chart and version, or fill in the fields by hand:

  • Helm Repository URL — oci://registry.mengi.cloud/<prefix>/charts/my-chart (or oci://registry.mengi.cloud/<prefix>/charts — both work)
  • Chart Name — my-chart
  • Version — 0.1.0

Mengi authenticates the chart pull for you. A deployment can only use charts from its own organization’s registry prefix.


Browse and clean up images

The page lists the repositories in your registry (name, artifact count, pull count) and the tags within each (with push time). Helm charts are marked with a Helm chart badge, and each version shows its ready-to-copy helm pull command. You can:

  • Delete a tag to remove a single image version or chart version.
  • Delete a repository to remove an image or chart and all its tags.

Good to know

  • Your account has one set of registry credentials; regenerate them to rotate the password.
  • The password is shown only once at creation — store it securely and never commit it to version control.
  • Images and charts are private to your account by default.