OpenShift Cluster Install Config Generator

0. Choose your installation approach

Use this guide to decide the best OpenShift installation path before filling full cluster details.

OpenShift installation flow (reference)

OpenShift installation flow

Start from which infrastructure you have and how you want to install; then narrow to IPI/UPI, agent-based or assisted, and whether you are disconnected.

Which infra?

Cloud Orchestrated (e.g. ROSA, OSD on AWS/Azure/GCP) or bring-your-own cloud.

On-prem Bare metal or virtualized (VMware, Nutanix, KVM, Hyper-V).

How?

Assisted (e.g. console.redhat.com, no dedicated bootstrap), local/agent-based, full control (UPI), or installer-provisioned (IPI).

Disconnected installs use a mirror registry (no direct internet from the cluster).

UPI

User-provisioned: you provide hardware or VMs (physical or virtual). You manage networking, DNS, load balancers, and node lifecycle.

IPI

Installer-provisioned: installer creates machines on supported cloud or virtualization (with credentials and permissions). Needs access to the virtual environment.

Supporting hosts (typical)

Bastion / jump host — Linux VM or bare metal; often same L2/L3 network as cluster nodes.
Bootstrap — temporary node for some flows (not required for all assisted/agent paths).

IPI install-config (examples)

Environment, control plane and worker counts, cluster and service networks.
VMware: vCenter user, datastore, cluster, port group.

Environment Provisioning model Prefer Agent-based installation Connectivity

1. Cluster settings

Platform

Installation method

Cluster name

Base domain

Enable FIPS

OpenShift minor (channel)

Architecture

OpenShift version (z-stream) Enter version manually

Machine network CIDR

Cluster network CIDR

Cluster host prefix

Service network CIDR

Disconnected installation (use internal registry mirrors)

Mirror registry host (optional)

Mirror repository prefix (optional)

Generate oc-mirror operator config

Pull secret (JSON, from Red Hat console)

SSH public key

2. Hosts (masters/workers)

For a compact cluster, define three master hosts and zero workers.

Hostname	Role	IP	MAC	Primary NIC	Bond?	Secondary NIC	Secondary MAC	Static IP?	Gateway	DNS servers (comma)

Rendezvous IP (one of the master IPs)

3. Actions

Compact cluster, bare metal / agent-based

4. Generated YAML

install-config.yaml

agent-config.yaml

oc-mirror ImageSetConfiguration (operators)

5. What to do next

After generating YAML:

Save install-config.yaml and (if present) agent-config.yaml to a working directory.
For disconnected installs, use imageContentSources, additionalTrustBundle, and operator-mirror-config.yaml with oc-mirror / oc adm release mirror to mirror content to your internal registry.
Run openshift-install agent create image --dir . in that directory to create a discovery ISO.
Boot your nodes from the ISO and monitor the installation until the cluster is ready.

6. Commands to run

Copy these commands and run them on your jump host / workstation as indicated.