Skip to content

openshift/external-registry

External registry URL for disconnected OpenShift installations

External Registry Configuration

This parameter specifies the URL of an external container registry for disconnected or air-gapped OpenShift installations. When set, the cluster will use this registry instead of Red Hat's public registries.

Requirements

  • Must be a valid container registry URL
  • Registry must be accessible from all cluster nodes
  • Must have sufficient storage for OpenShift images
  • Must support both HTTP and HTTPS
  • Must have required OpenShift images mirrored

Usage

Configure the registry URL: 

# Example formats:
registry.example.com             # Standard hostname
registry.example.com:5000        # Custom port
192.168.1.100:5000              # IP address

# Registry will serve (by default in sources):
- OpenShift release images
- Red Hat core images
- UBI base images
- OpenShift serverless images
- Service mesh images

Notes: - Required for disconnected installations - Works with openshift/external-registry-create - Used by openshift/external-registry-update - Affects install-config.yaml generation - Requires proper certificates and authentication

Objects that Reference openshift/external-registry

Objects used by openshift/external-registry

Not used in current content packs