Skip to main content

Set up a private registry

Big picture

Add Calico Cloud images to a private registry to install new clusters or update existing ones.


In some deployments, installing Calico Cloud in clusters from third-party repos is not an option. Before you can install Calico Cloud from a private registry, you must first add Calico Cloud images to the registry.


A container image registry (often known as a registry), is a service where you can push, pull, and store container images. In Kubernetes, a registry is considered private if it is not publicly available.

A private registry is not publicly available. It must be accessible on a private network or with an image pull secret for authenticated access.

An image path is a directory in a registry that contains images required to install Calico Cloud.

Before you begin


  • Helm CLI command
  • Use the Crane command to follow steps in this guide. (Other tools can be used, but commands be adjusted accordingly.)
  • Image registry
    • Must be private (accessible only on a private network or using log in credentials)
    • Images copied to the registry must not be made publicly available
    • Push access to your registry

How to

Add the required Calico Cloud images to a private registry.

Set up registry credentials

  1. Log into Calico Cloud and navigate to "Managed Clusters".
  2. Get the "Registry Credentials" by clicking on the icon. registry credentials
  3. Apply the credentials so the Calico Cloud images can be accessed.

Create the list of required images

helm repo add calico-cloud
INSTALLER_IMAGE="$(helm show chart calico-cloud/calico-cloud | grep version: | sed -e 's/version: *//' -e 's/+/-g/')"

Set up the private registry

REGISTRY=<replace with your registry and include a trailing slash>

If you want all images to come from the same path in your registry, set this image path value. Otherwise unset this environment variable or set it to the empty string.


Image examples

Original imageImage RegistryImage PathPrivate registry image

Copy images to your registry

For Calico Cloud to install images from your registry, copy the images from the standard registries into your own registry.

for image in ${IMAGES[@]}; do
img_base=$(echo ${image} | sed "s#^.*/\([^/]*/[^/]*$\)#\1#")
crane cp ${image} ${REGISTRY}${img_base} || break

Install using the private registry

Follow the directions to connect a cluster to Calico Cloud.