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

Here is the correct and updated step-by-step guide to install and configure OpenShift Local (formerly CRC – CodeReady Containers) on Linux laptops/desktops for local development and testing.

🐧 OpenShift Local on Linux – Overview

✅ System Requirements

🧰 Step 1: Install Required Packages

🔹 Fedora / RHEL / CentOS:

sudo dnf install @virtualization libvirt libvirt-daemon-kvm qemu-kvm
sudo systemctl enable --now libvirtd
sudo usermod -a -G libvirt $(whoami)
Code language: JavaScript (javascript)

🔹 Ubuntu / Debian:

sudo apt update
sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager
sudo systemctl enable --now libvirtd
sudo usermod -aG libvirt $(whoami)
Code language: JavaScript (javascript)

🔁 Logout and re-login to apply group changes.

📥 Step 2: Download OpenShift Local (CRC) & Pull Secret

1. Visit: https://console.redhat.com/openshift/create/local
2. Sign in or register with a free Red Hat account.
3. Download:
   • Linux CRC archive (e.g. crc-linux-amd64.tar.xz)
   • Pull Secret and save it as pull-secret.txt

📦 Step 3: Install the crc Binary

tar -xvf crc-linux-*.tar.xz
sudo mv crc-linux-*/crc /usr/local/bin/crc
Code language: JavaScript (javascript)

Check the version:

crc version

🔧 Step 4: Setup the Cluster

crc setup --pull-secret ~/Downloads/pull-secret.txt
Code language: JavaScript (javascript)

Replace the path to the actual location of your pull secret.

▶️ Step 5: Start the OpenShift Cluster

crc start

• This initializes and boots the OpenShift VM
• Takes 5–15 minutes to fully start

🌐 Step 6: Access the Web Console

After the cluster starts, it will output a URL like:

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

Login Credentials:

Open the URL in your browser and login using the credentials.

🧪 Step 7: Use the OpenShift CLI

Configure CLI access:

eval $(crc oc-env)
Code language: JavaScript (javascript)

Login via CLI:

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

You can now deploy workloads, create namespaces, and test apps locally.

🔁 Cluster Management Commands

⚠️ Common Issues & Fixes

📎 Notes

• CRC installs a single-node OpenShift cluster optimized for development.
• It’s not meant for production or multi-node use.
• Automatically sets up a VM using libvirt with a .crc domain.

Rajesh Kumar

I’m a DevOps/SRE/DevSecOps/Cloud Expert passionate about sharing knowledge and experiences. I have worked at Cotocus. I share tech blog 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 TrueReviewNow , 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 WIZBRAND

Rajesh Kumar DailyLogs