🚀 DevOps & SRE Certification Program 📅 Starting: 1st of Every Month 🤝 +91 8409492687 🔍 Contact@DevOpsSchool.com

Upgrade & Secure Your Future with DevOps, SRE, DevSecOps, MLOps!

We spend hours on Instagram and YouTube and waste money on coffee and fast food, but won’t spend 30 minutes a day learning skills to boost our careers.
Master in DevOps, SRE, DevSecOps & MLOps!

Learn from Guru Rajesh Kumar and double your salary in just one year.


Get Started Now!

Openshift Local: crc troubleshooting guide

If crc is not creating a VM even after setup, and you’re using Windows 11 with Hyper-V, here’s how you can check the logs and troubleshoot the issue:


✅ 1. View Detailed Logs from CRC

Run this command to get verbose debug logs:

crc start -l debug

or for even more detailed logging:

crc start --log-level debug

This will print detailed steps of what crc is doing, where it’s failing, and may show VM or Hyper-V issues.


✅ 2. Check Log Files Manually

CRC stores logs in this location on Windows:

C:\Users\<your-username>\.crc\logs

Check the latest folder in that directory for a file like:

crc.log

You can open it in Notepad or any text editor to see detailed setup/start information.


✅ 3. Confirm Prerequisites

Let’s double-check a few required things:

ItemCheck
✅ Hyper-V installedRun Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All in PowerShell
✅ User is in Hyper-V Administrators GroupRun net localgroup "Hyper-V Administrators"
✅ Virtualization Enabled in BIOSCheck from Task Manager → Performance → CPU
✅ Installed CRC with InstallerMake sure you used the .msi installer, not just a ZIP

If any of these aren’t properly configured, CRC won’t be able to start the VM.


✅ 4. Manually Check Hyper-V VM

Check if a CRC VM was created but failed to start:

Get-VM

You may see something like crc listed. If it’s there but “Off” or in a failed state, try:

Start-VM -Name crc

And if that fails, get the error:

Get-VM -Name crc | Get-VMIntegrationService

✅ 5. Clean Up and Retry (if needed)

If everything fails, you can try resetting and starting fresh:

crc cleanup
crc setup
crc start --log-level debug

Here is a Complete OpenShift Local (CRC) Troubleshooting Guide tailored for Windows (especially Windows 11), covering installation, VM, daemon, logs, and networking issues — all in one place:


✅ Complete OpenShift Local (CRC) Troubleshooting Guide for Windows


🧰 1. Basic CRC Setup Checklist (Before Troubleshooting)

RequirementNotes
OSWindows 10/11 Pro, Enterprise, or Education (Hyper-V required)
RAMMinimum 9 GB free (16 GB total preferred)
Disk SpaceAt least 35 GB free
VirtualizationMust be enabled in BIOS
Hyper-V InstalledRequired – CRC won’t work with VirtualBox
Admin RightsMust run CRC setup and start as Administrator
CRC Installed via MSIAlways use the official Windows .msi installer
Reboot PerformedAfter install – mandatory

🛠️ 2. Installation & Setup

✅ Correct Installation Steps:

crc cleanup
crc setup

Always reboot after installation.


🧪 3. Common Issues and Fixes

❌ Issue 1: CRC Daemon Not Running

Error:

Is 'crc daemon' running? Cannot reach daemon API

Fix:

# Open PowerShell as Admin
crc daemon

Keep this terminal open while you run crc start in another one.


❌ Issue 2: No VM is created

Fix:

  • Confirm virtualization:
Get-VM
  • Retry clean setup:
crc cleanup
crc setup
crc daemon
crc start --log-level debug

❌ Issue 3: Hyper-V Not Enabled

Fix: Run as Admin:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Then reboot.


❌ Issue 4: Podman or oc not found

Fix: Check:

dir C:\Users\<your-user>\.crc\bin

If missing, re-run:

crc setup

❌ Issue 5: DNS/Networking Failures

Fix:

  • Add api.crc.testing and *.apps-crc.testing to hosts file:
notepad C:\Windows\System32\drivers\etc\hosts

Add:

192.168.130.11 api.crc.testing
192.168.130.11 console-openshift-console.apps-crc.testing

Replace 192.168.130.11 with the output of:

crc ip

🧾 4. Useful CRC Commands

PurposeCommand
Setup CRCcrc setup
Start clustercrc start --log-level debug
Stop clustercrc stop
Delete everythingcrc delete
Cleanup cache/machines/logscrc cleanup
Show statuscrc status
Get CRC IPcrc ip
Open dashboardcrc console

📁 5. Log File Locations

Manual Log Inspection:

C:\Users\<your-user>\.crc\logs\crc.log

Look for errors like:

  • “VM creation failed”
  • “Daemon not reachable”
  • “Failed to mount disk”

📦 6. Bundle File Missing or Corrupt

If crc shows:

Bundle not found: crc_hyperv_xxx.crcbundle

Fix:

  1. Download bundle manually: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/latest/
  2. Place in:
C:\Users\<your-user>\.crc\cache

🌐 7. Accessing the Cluster

  1. Run:
crc console
  1. Login with:
    • Username: kubeadmin
    • Password: found at: C:\Users\<your-user>\.crc\cache\...<bundle>\kubeadmin-password
  2. Get oc tool path:
crc oc-env

💡 8. Tips & Best Practices

Tip
Always run crc in PowerShell (Admin)
Do not move .crcbundle file after setup
Avoid running CRC inside a VM
Check Windows Defender or antivirus — it can block Hyper-V or crc.exe
Ensure enough free RAM + Disk Space

📞 9. When All Else Fails

  • Update CRC to the latest version
  • Re-download the bundle
  • Reset:
crc delete
crc cleanup
  • Reboot
  • Start again

Subscribe
Notify of
guest


0 Comments
Newest
Oldest Most Voted
Inline Feedbacks
View all comments

Certification Courses

DevOpsSchool has introduced a series of professional certification courses designed to enhance your skills and expertise in cutting-edge technologies and methodologies. Whether you are aiming to excel in development, security, or operations, these certifications provide a comprehensive learning experience. Explore the following programs:

DevOps Certification, SRE Certification, and DevSecOps Certification by DevOpsSchool

Explore our DevOps Certification, SRE Certification, and DevSecOps Certification programs at DevOpsSchool. Gain the expertise needed to excel in your career with hands-on training and globally recognized certifications.

0
Would love your thoughts, please comment.x
()
x