Generate the discovery ISO

Installing OpenShift Container Platform on a single node requires a discovery ISO, which the Assisted Installer (AI) generates with the cluster name, base domain, Secure Shell (SSH) public key, and pull secret.

  1. On the administration node, open a browser and navigate to Install OpenShift with the Assisted Installer.

  2. Click Create New Cluster to create a new cluster.

  3. In the Cluster Name field, enter a name for the cluster.

  4. In the Base Domain field, enter a base domain. For example:


    All DNS records must be subdomains of this base domain and include the cluster name. You cannot change the base domain after cluster installation. For example:

  5. Select "I want to install single node OpenShift (SNO)".

  6. Read the limitations for installing OpenShift Container Platform on a single node.

  7. Select "I understand, accept, and agree to the limitations associated with using Single Node OpenShift".

  8. Select the OpenShift Container Platform version.

  9. Click Next.

  10. Click Generate Discovery ISO.

  11. Select Full ISO to boot with a USB drive or PXE. Select Minimal ISO to boot with virtual media.

  12. Add the Secure Shell public key of the administration node to the Public key field.

  13. Click Generate Discovery ISO.

  14. Download the discovery ISO.

  15. Make a note of the discovery ISO URL for installing with virtual media.

Installing with USB media

Installing with USB media involves creating a bootable USB drive with the discovery ISO on the administration node. Booting the server with the USB drive prepares the node for a single node installation.

  1. On the administration node, insert a USB drive into a USB port.

  2. Create a bootable USB drive:

    # dd if=<path-to-iso> of=<path/to/usb> status=progress

    For example:

    # dd if=discovery_image_sno.iso of=/dev/sdb status=progress

    After the ISO is copied to the USB drive, you can use the USB drive to install OpenShift Container Platform.

  3. On the server, insert the USB drive into a USB port.

  4. Reboot the server and enter the BIOS settings upon reboot.

  5. Change boot drive order to make the USB drive boot first.

  6. Save and exit the BIOS settings. The server will boot with the discovery image.

  7. On the administration node, return to the browser and refresh the page. If necessary, reload the Install OpenShift with the Assisted Installer page and select the cluster name.

  8. Click Next until you reach step 3.

  9. Select a subnet from the available subnets.

  10. Keep Use the same host discovery SSH key checked. You can change the SSH public key, if necessary.

  11. Click Next to step 4.

  12. Click Install cluster.

  13. Monitor the installation’s progress. Watch the cluster events. After the installation process finishes writing the discovery image to the server’s drive, the server will reboot. Remove the USB drive and reset the BIOS to boot to the server’s local media rather than the USB drive.

The server will reboot several times, deploying a control plane followed by a worker.