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
- Visit: https://console.redhat.com/openshift/create/local
- Log in or create a free Red Hat account.
- Download the Windows installer (e.g.,
crc-windows-installer.exe
). - Also download your Pull Secret and save it as
pull-secret.txt
.
๐น Step 3: Install OpenShift Local (CRC)
- Run the downloaded
.exe
file (e.g.,crc-windows-installer.exe
). - It installs the
crc
CLI and adds it to your system PATH. - 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:\path\to\pull-secret.txt
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
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
๐ 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 |
Iโm a DevOps/SRE/DevSecOps/Cloud Expert passionate about sharing knowledge and experiences. I am working at Cotocus. I blog tech insights at DevOps School, travel stories at Holiday Landmark, stock market tips at Stocks Mantra, health and fitness guidance at My Medic Plus, product reviews at I reviewed , and SEO strategies at Wizbrand.
Do you want to learn Quantum Computing?
Please find my social handles as below;
Rajesh Kumar Personal Website
Rajesh Kumar at YOUTUBE
Rajesh Kumar at INSTAGRAM
Rajesh Kumar at X
Rajesh Kumar at FACEBOOK
Rajesh Kumar at LINKEDIN
Rajesh Kumar at PINTEREST
Rajesh Kumar at QUORA
Rajesh Kumar at WIZBRAND