# Install Bundle from a Private Image Registry

This tutorial provides to way to utilize bundles from a private image registry in your Entando projects. The steps below use environment variables to pass the Secret for authentication required by private registries.

For microservices in a private image registry, follow the install guide here.

# Prerequisites

# Tutorial

# Step 1: Create the Registry Credentials

  1. Create the registry JSON configuration using your registry and credentials on the port of your choice:
  "auths": {
    "YOUR-REGISTRY.com": {
       "username": "YOUR-USERNAME",
       "password": "YOUR-PASSWORD"

  1. Convert the JSON configuration into a base64 string (opens new window)

# Step 2: Create and Apply the Secret

  1. Create container-registry-secret.yaml in your namespace with the following snippet. Replace the registryCredentials value with your own.
kind: Secret
apiVersion: v1
   name: container-registry-secret
type: Opaque
   registryCredentials: "ewogICJhdXRocyI6IHsKICAgICJyZWdpc3RyeS5odWIuZG9ja2VyLmNvbSI6IHsKICAgICAgICAidXNlcm5hbWUiOiAidGVzdG5hbWV4eHgiLAogICAgICAgICJwYXNzd29yZCI6ICJUZXN0bmFtZXBhc3N3ZCIKfQp9Cn0="
  1. Apply the registry Secret YAML to your Entando instance, replacing the namespace with your own as needed:
kubectl apply -f container-registry-secret.yaml -n entando

# Step 3: Add the Environment Variable and Deploy

  1. Add the environment variable, ENTANDO_CONTAINER_REGISTRY_CREDENTIALS, to your EntandoApp custom resource. To edit the EntandoApp using your namespace:
kubectl get EntandoApp -n entando
kubectl edit EntandoApp/quickstart -n entando
  1. Add the environmentVariables under the spec property as shown here:
kind: EntandoApp
               name: container-registry-secret
               key: registryCredentials

  1. The Component Manager (CM) deployment requires modification due to an open issue with Entando 7.1.1. Scale the deployment down to 0, add the following spec for the HOME variable, and then restart the CM.
  - env:
    - name: HOME
      value: /deployments
  1. Deploy and install the bundle into Entando:
ent bundle deploy
ent bundle install

Next Steps