Skip to main content
Version: latest

Upload Cluster Images to Registry with Palette Edge CLI

Palette Edge allows you to deploy a cluster using an external private registry. When you deploy a cluster using an external registry, all images required by the cluster are expected to be in the registry before deployment starts.

It can be error-prone to upload the images manually one by one. Therefore, we recommend you use the Palette Edge CLI to download the images and upload them to the external registry.


  • Linux Machine (Physical or VM) with an AMD64 architecture.

  • Palette API key. Refer to the User Authentication resource to learn how to create a Palette API key.

  • An Edge Native cluster profile. Refer to Create Edge Native Cluster Profile guide to learn how to create an Edge Native cluster profile. You may also have other add-on profiles that you wish to attach to your cluster.

  • Content tags in your profiles highlight the exact location of container images to be downloaded.

Upload Cluster Images to Registry

  1. Download Palette Edge Content CLI and assign the executable bit to the CLI.

    chmod +x palette-edge
  2. Log in to Palette.

  3. Select the project you want to deploy the Edge host to and copy down the Project ID. You can find the project id at the top right side corner of the landing page below the User drop-down Menu.

  4. Navigate to the left Main Menu and select Profiles.

  5. Click on the cluster profile you want to include in the content bundle.

  6. You can find the cluster profile ID by reviewing the URL of the current page. The cluster profile ID is the last value in the URL. Repeat this step for all the cluster profiles whose images you want to include in the content bundle.

  7. If you are downloading images from public image or Helm registries only, skip this step.

    Prepare a JSON file that includes the credentials to your image or Helm registries.

    For authenticated access to Helm charts, your must provide credentials with the following schema. Use a key at the root level of the JSON object named "helm" and set its value to a list. The list is a list of credentials for each Helm chart repository. For each set of credentials, use an object in the list with the keys "endpoint", "username", and "password".

    "helm": [
    "endpoint": <Registry URL>,
    "username": <Registry username>,
    "password": <Password>

    For example, the following JSON code is a valid set of credentials.

    "helm": [
    "endpoint": "",
    "username": "admin",
    "password": "xxxxxxxx"
  8. Issue the following command to download the images as a content bundle. The command produces a ZST file as output. Replace the ****** after the --api-key flag with your Palette API key. Replace project-ID with the ID of your project in Palette, palette-api-endpoint with your Palette API endpoint, and profile-ID with the ID of your profile.

     ./palette-edge build --api-key ****** \
    --project-id project-ID \
    --cluster-profile-ids profile-ID \
    --palette-endpoint palette-API-endpoint \
    --outfile output-file-name \
    --cred-file-path registry-creds.json \
  9. Issue the following command to upload the images to the external registry. Replace path-to-content-bundle with the path to the content bundle you downloaded in the previous step. Replace registry-URL with the URL of your external registry. Replace username and ****** with the username and password used to access the external registry.

    ./palette-edge deploy --export path-to-content-bundle --url registry-URL \
    --username username --password ******


Go to your external registry and verify that all the images referenced in the cluster profile are uploaded to the external registry.