Chapter 3. Configure image mirroring for disconnected environments


If your Openshift Container Platform cluster operates in a disconnected or restricted network environment, configure an ImageDigestMirrorSet custom resource (CR) to mirror container images from the Red Hat registry to your local mirror registry.

Prerequisites

  • You have installed the OpenShift CLI (oc).
  • You have logged in as a user with cluster-admin privileges.
  • You have set up a mirror registry for your disconnected environment. For more information, see Creating a mirror registry.
  • You have mirrored the required Distributed Inference with llm-d images to your local registry.

Procedure

  1. Create an ImageDigestMirrorSet to mirror images from registry.redhat.io/rhoai to your mirror registry:

    $ oc apply -f - <<'EOF'
    apiVersion: config.openshift.io/v1
    kind: ImageDigestMirrorSet
    metadata:
      name: rhoai-mirror
    spec:
      imageDigestMirrors:
        - mirrors:
            - <LOCAL_MIRROR_REGISTRY>/rhoai
          source: registry.redhat.io/rhoai
    EOF

    Wait for the machine config pools to update:

    $ oc wait mcp master worker --for=condition=Updated=True --timeout=600s
    Note

    On single-node OpenShift or compact clusters, the worker machine config pool might not exist. If the command fails, run oc get mcp to list available pools and wait on only the pools present in your cluster.

  2. Verify that the cluster pull secret includes credentials for registry.redhat.io:

    $ oc get secret pull-secret -n openshift-config \
      -o jsonpath='{.data.\.dockerconfigjson}' | base64 -d | jq -r '.auths | keys[]'

    The output must include quay.io and registry.redhat.io. If either entry is missing, update the pull secret:

    $ oc get secret pull-secret -n openshift-config \
      -o jsonpath='{.data.\.dockerconfigjson}' | base64 -d > /tmp/pull-secret.json

    Add the missing registry credentials to the auths block in /tmp/pull-secret.json, then apply:

    $ oc set data secret/pull-secret -n openshift-config \
      --from-file=.dockerconfigjson=/tmp/pull-secret.json

    Wait for the machine config pools to update:

    $ oc wait mcp master worker --for=condition=Updated=True --timeout=600s
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top