OpenShift Install & Configurations using OpenShift Local in windows laptops/desktops

Below is the 100% correct and updated step-by-step guide to install and configure OpenShift Local (aka CRC) on Windows 10/11 laptops or desktops using the correct crc commands.

---

✅ Overview: What You’re Installing

Component	Description
OpenShift Local	Official local dev tool to run OpenShift 4.x
CRC CLI Tool	Still named crc.exe (not openshift-local)
Runs	A single-node OpenShift cluster using Hyper-V

---

🧩 Prerequisites

Requirement	Value / Notes
OS	Windows 10/11 (64-bit)
RAM	Min 9 GB (Recommended: 16 GB)
CPU	Min 4 cores
Disk	At least 35 GB free
Virtualization	Must be enabled in BIOS
Hypervisor	Hyper-V (enabled)

---

🛠️ Step-by-Step Guide

🔹 Step 1: Enable Hyper-V & Virtualization

Open PowerShell as Administrator and run:

dism.exe /Online /Enable-Feature:Microsoft-Hyper-V /All /NoRestart

Then restart your system.

---

🔹 Step 2: Download OpenShift Local & Pull Secret

1. Visit: https://console.redhat.com/openshift/create/local
2. Log in or create a free Red Hat account.
3. Download the Windows installer (e.g., crc-windows-installer.exe).
4. Also download your Pull Secret and save it as pull-secret.txt.

---

🔹 Step 3: Install OpenShift Local (CRC)

1. Run the downloaded .exe file (e.g., crc-windows-installer.exe).
2. It installs the crc CLI and adds it to your system PATH.
3. Open Command Prompt or PowerShell, and verify:

crc version

---

🔹 Step 4: Setup the Cluster

In PowerShell or Command Prompt, run:

crc setup --pull-secret C:pathtopull-secret.txt
Code language: CSS (css)

Replace the path with the full path to your pull-secret.txt file.

---

🔹 Step 5: Start the Cluster

crc start

• This will launch a single-node OpenShift 4 cluster inside a Hyper-V VM.
• It may take 5–10 minutes to complete.

---

🔹 Step 6: Access OpenShift Web Console

After the cluster starts, you’ll see output like:

Started the OpenShift cluster.

Console URL: https://console-openshift-console.apps-crc.testing
Code language: JavaScript (javascript)

Login Credentials:

Role	Username	Password
Admin	kubeadmin	(shown in terminal)
Developer	developer	developer

Open the web console in your browser and use these credentials.

---

🔹 Step 7: Access via CLI (Optional)

To set up oc (OpenShift CLI), run:

crc oc-env

Then copy and paste the output into your shell to make oc available.

Log in:

oc login -u developer -p developer https://api.crc.testing:6443
Code language: JavaScript (javascript)

---

🔁 Optional Cluster Management

Action	Command
Stop cluster	crc stop
Delete cluster	crc delete
Status check	crc status

---

🧹 Uninstall (if needed)

To uninstall CRC:

• Go to Control Panel → Programs → Uninstall a Program → Remove CodeReady Containers.

---

⚠️ Common Issues

Problem	Solution
Hyper-V not found	Ensure virtualization is enabled in BIOS
CRC command not found	Reboot or check if the PATH was updated after install
Slow startup	Close heavy apps, ensure enough RAM/CPU are free
DNS resolution fails	Disable VPNs; CRC uses crc.testing local domain

---