Skip to main content

Install

Install Cockpit OpenShift on the KVM/libvirt host that will run the local OpenShift deployment workflow. Use the RPM path when you want a package-managed install. Use the source path when you are developing or testing local plugin changes.

Prerequisites​

  • Cockpit is installed on the KVM host
  • libvirt is installed and usable on the KVM host
  • virt-install tooling is installed on the KVM host
  • the target libvirt storage pool already exists
  • the host can reach the OpenShift public mirror to download installer assets
  • the operator has a valid pull secret, SSH public key, cluster DNS, node IPs, and VIPs for the chosen topology

Preinstalled oc and openshift-install binaries are not required. The backend downloads and pins its own copies under /var/lib/cockpit-openshift/.

Install Methods​

Build the RPM from the project directory and install the generated package:

sudo dnf install -y rpm-build
cd /path/to/cockpit-openshift
./build-rpm.sh
sudo dnf install -y ./rpmbuild/RPMS/noarch/cockpit-openshift-0.1.0-1.el10.noarch.rpm

The exact RPM filename depends on the build host distribution suffix.

Open The Plugin​

Start Cockpit if it is not already running:

sudo systemctl enable --now cockpit.socket

Open https://<host>:9090 and navigate to OpenShift.

Cockpit discovers the plugin on page load. If the plugin files are installed under /usr/share/cockpit/cockpit-openshift/, the Cockpit navigation exposes it as OpenShift.