OpenShift Installation Guide (Agent-Based and Appliance)

This document covers the OpenShift installation process for bare metal and virtual machines using the agent-based installer and the appliance builder, targeting OpenShift 4.18 through 4.20. 1. OpenShift Appliance Image Provisioning 1.1 Overview The openshift-appliance utility builds a self-contained disk image that orchestrates OpenShift installation using the agent-based installer. Its primary use case is fully disconnected (air-gapped) installations where no internet connectivity or external container registries are available. All required container images (the OCP release payload, operators, additional images) are embedded directly in the disk image. The resulting image is generic: the same image can deploy multiple different OpenShift clusters. Cluster-specific configuration is provided separately via a config-image ISO at deployment time. ...

February 25, 2026 · 24 min · Robin Jarry