Skip to main content

How I created a Red Hat OpenShift cluster on tiny hardware

Build an OpenShift cluster on a small, sub-$300 computer.
Hands holding a small package

Photo by Liza Summer from Pexels

I wanted to run Red Hat OpenShift on the smallest form factor I could. This article covers the hardware I selected and the general configuration steps that worked for me. You could easily do something similar and modify the steps to match your needs.

My understanding is that there are at least three OpenShift flavors to cover different on-premises use cases. The following are the hardware requirements for each one:

Once I knew what I needed for this project, I could start building it.

[ Learn the basics of using Kubernetes in this cheat sheet. ]

Find the hardware

I didn't want to miss any OpenShift features, so I needed a machine with 8 vCPU or, in other words, a server with a 4-core processor (8 threads) to run OpenShift on a single node (SNO).

I found a refurbished ThinkCentre M910 Tiny with an Intel Core i7-6700T processor that met the requirements for about $280.

Photo of a ThinkCentre 910 device
(Nicolas Leiva, CC BY-SA 4.0)

[ Learning path: Getting started with Red Hat OpenShift Service on AWS (ROSA)

Create an OpenShift cluster

I have installed Kubernetes the hard way many times now, so I was prepared to follow lengthy instructions. Fortunately, OpenShift has streamlined this process. Aside from a couple of caveats I'll explain, the process went smoothly, providing a good user experience.

My homelab has a Ubiquiti gateway to connect to the internet, and I use AdGuard Home for DNS.

Home topology showing gateway, DNS, and server
(Nicolas Leiva, CC BY-SA 4.0)

To start the process, go to and select Datacenter > Bare Metal > Interactive (installation method). If you don't have a Red Hat account, you can create one for free and run an OpenShift trial.

OpenShift Assisted Installer interface
(Nicolas Leiva, CC BY-SA 4.0)

Next, name your cluster and select Install single-node OpenShift (SNO):

Screenshot showing naming the cluster in the OpenShift Installer interface
(Nicolas Leiva, CC BY-SA 4.0)

I named my cluster in and used lab.home for the base domain.

The setup provides the operators options to Install OpenShift Virtualization and Logical Volume Manager Storage. Do not select them if you only have 8 vCPUs like me, as OpenShift Virtualization adds 6 vCPU to the requirements. Logical Volume Manager Storage adds 1 vCPU.

The next step is to generate an ISO for any node you want to add. There's only one node in this case.

Screenshot showing "Add host" screen
(Nicolas Leiva, CC BY-SA 4.0)

Click on Generate Discovery ISO, and off you go. The file size is approximately 1.1 GB.

Before booting this ISO on the server, you need to add a couple of DNS entries, as noted in the Requirements for installing OpenShift on a single node.

  • Kubernetes API: api.<cluster_name>.<base_domain>
  • Ingress route: *.apps.<cluster_name>.<base_domain>
  • Internal API: api-int.<cluster_name>.<base_domain>

This configuration translates to the following, where is the IP address I statically allocate via DHCP to the server:

Screenshot showing how to add the DNS entries in Adguard Home
(Nicolas Leiva, CC BY-SA 4.0)

With DNS out of the way, I can now run the generated ISO on the server.

[ Want to test your sysadmin skills? Take a skills assessment today. ]

Boot from the ISO

You need a USB stick that the server can boot from. I use Fedora Media Writer to make a USB stick bootable with an ISO file.

To tell the server to boot from the USB stick, press F12 after powering on the computer to reach the boot menu. Then select USB and let it run.

Boot menu screenshot
(Nicolas Leiva, CC BY-SA 4.0)

This server has WiFi, so I must disable it to avoid kernel panics. In the boot menu, I selected Enter Setup. In Network Setup, I changed Wireless LAN to Disabled. Your system may have similar considerations.

Screenshot of the BIOS network setup to disable the wireless NIC
(Nicolas Leiva, CC BY-SA 4.0)

After that, you can safely boot from the USB stick. The host will eventually show up as ready to install in the assisted installer interface:

Screenshot of the OpenShift Assisted Installer interface showing host is ready
(Nicolas Leiva, CC BY-SA 4.0)

Now it's time to select the cluster's internal networks. I used the defaults (,, and I picked dual-stack support to leverage IPv6 (fd01::/48, fd02::/112). It looks like this:

Screenshot of installation progress interface
(Nicolas Leiva, CC BY-SA 4.0)

After this, the installer takes care of all the rest. You no longer need to look at the server screen.

If the hosts in your home network want to access any of the services you deploy in OpenShift, they will need to know how to reach the cluster's internal networks you just configured (,, fd01::/48, and fd02::/112). There are ways to do this dynamically, but for this example, I can simply create static routes in the Gateway pointing to the server:

Screenshot showing creating a new static route
(Nicolas Leiva, CC BY-SA 4.0)

[ No-cost online course: Red Hat Enterprise Linux technical overview. ]

Install the OpenShift command-line interface (CLI)

You can check if everything is working from your computer with the OpenShift CLI. You can download this utility from the OpenShift console.

But first, from the cluster view, download your kubeconfig by clicking on the Download kubeconfig button. Copy the password to access the console (user kubeadmin).

OpenShift interface showing cluster view
(Nicolas Leiva, CC BY-SA 4.0)

Click the Open Console button, or go to the URL https://console-openshift-console.apps.<cluster_name>.<base_domain>. In this example, it is

From the web console, click ? to see the link to Command line tools or go to https://console-openshift-console.apps.<cluster_name>.<base_domain>/command-line-tools.

Move the binary you downloaded to a location on your computer that is in your PATH. In this example, I used:

$ mv ~/Downloads/oc-4.12.2-linux/* ~/bin

To authenticate with the Kubernetes API, you must move the kubeconfig to ~/.kube/config:

$ mv ~/Downloads/kubeconfig ~/.kube/config

Enjoy OpenShift

At this point, you should be able to contact the cluster from your computer:

⇨ oc cluster-info

Kubernetes control plane is running at

You can check the node's status with the oc get nodes command:

 ⇨ oc get nodes


host3.lab.home Ready control-plane,master,worker 152m  


For more commands, check the CLI reference.

Wrap up

The installation process has come a long way. In my next article, I'll show how to scale Ansible Automation Platform with OpenShift.

[ Learn about upcoming webinars, in-person events, and more opportunities to increase your knowledge at Red Hat events. ]

Thanks to Chris Keller and Juan Jose Floristan for their support in setting up my single-node cluster. I would still be banging my head against the wall if it wasn't for them.

Topics:   OpenShift   Kubernetes   Homelabs  
Author’s photo

Nicolas Leiva

Nicolas is a technology professional with 14 years of experience helping customers design, deploy, and operate large-scale networks, with an emphasis on infrastructure automation. Cisco Certified Design Expert (CCDE) and Internetwork Expert (CCIE). More about me

Try Red Hat Enterprise Linux

Download it at no charge from the Red Hat Developer program.