DevOps · K8s · Volleyball · Travel  •  DevOps · K8s · Volleyball · Travel  •  DevOps · K8s · Volleyball · Travel
Explore NY Stream

Set Up a Local OpenShift Origin (OKD) Cluster on CentOS 7

— ny_wk

Set Up a Local OpenShift Origin (OKD) Cluster on CentOS 7

Want a real OpenShift environment to learn or test on, without a cloud bill? OpenShift Origin (OKD) — the upstream community version of OpenShift — can run as a local single-node cluster on one CentOS 7 VM. The dev team made it refreshingly simple: a single command brings the cluster up.

Recommended VM specs

OpenShift is hungry. For a comfortable local cluster:

  • 8 vCPUs
  • 32 GB RAM
  • 50 GB free disk
  • CentOS 7

You can scrape by with less for light testing, but give it room or it'll crawl.

Step 1 — Update CentOS

Start fresh: sudo yum update -y, then reboot if the kernel updated.

Step 2 — Install and configure Docker

OKD 3.x runs on Docker. Install it, then add an insecure-registry entry for the internal OpenShift registry CIDR (e.g. 172.30.0.0/16) in the Docker daemon config, and start Docker. This lets the cluster pull from its internal registry.

Step 3 — Get the OpenShift client (oc)

Download the oc client binary that matches the OKD version, extract it, and move it into /usr/local/bin so it's on your PATH. Confirm with oc version.

Step 4 — Bring the cluster up

This is the magic one-liner:

oc cluster up

It pulls the required images and stands up a local single-node OpenShift cluster, printing the web console URL and login details when it finishes.

Step 5 — Log in and explore

Open the console URL it gave you, or log in on the CLI as the developer user (oc login -u developer). Create a project, deploy a sample app from the catalog, and you have a working OpenShift to play with.

(Note: OKD 3.x and oc cluster up are the older approach; OpenShift 4 / OKD 4 use a different installer, but the 3.x local cluster is still a fast way to learn the platform.)

Key takeaways

  • OKD is the free, upstream community build of OpenShift — perfect for local learning.
  • Give the VM real resources: ~8 vCPU / 32 GB RAM / 50 GB disk on CentOS 7.
  • Install Docker (with the internal registry as an insecure registry) + the oc client.
  • oc cluster up stands up the whole local cluster in one command.

Frequently asked questions

Is OKD the same as OpenShift?

OKD is the open-source upstream of Red Hat OpenShift — same core, community-supported, free.

Can I run it on less than 32 GB RAM?

For light testing yes, but performance suffers. OpenShift's control plane is resource-heavy.

What does oc cluster up do?

It pulls the images and launches a local single-node OpenShift cluster, then prints the console URL and credentials.

Should I use this for OpenShift 4?

No — oc cluster up is for 3.x. OKD/OpenShift 4 use a dedicated installer (and tools like CodeReady Containers for local).

One VM, Docker, the oc client, and a single command — that's the fastest path to a hands-on OpenShift cluster on your own machine.