{"id":49260,"date":"2025-05-04T15:16:04","date_gmt":"2025-05-04T15:16:04","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49260"},"modified":"2025-07-12T05:54:58","modified_gmt":"2025-07-12T05:54:58","slug":"openshift-install-configurations-using-openshift-local-in-linux-laptops-desktops","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/openshift-install-configurations-using-openshift-local-in-linux-laptops-desktops\/","title":{"rendered":"OpenShift Install & Configurations using OpenShift Local in Linux laptops\/desktops"},"content":{"rendered":"\n

Here is the correct and updated step-by-step guide<\/strong> to install and configure OpenShift Local<\/strong> (formerly CRC \u2013 CodeReady Containers) on Linux laptops\/desktops<\/strong> for local development and testing.<\/p>\n\n\n\n

\n\n\n\n

\ud83d\udc27 OpenShift Local on Linux \u2013 Overview<\/h2>\n\n\n\n
Feature<\/th>Description<\/th><\/tr><\/thead>
Product Name<\/td>OpenShift Local (formerly CodeReady Containers – CRC)<\/td><\/tr>
CLI Tool Name<\/td>crc<\/code><\/td><\/tr>
Cluster Type<\/td>Single-node OpenShift 4.x cluster<\/td><\/tr>
Virtualization<\/td>Uses QEMU\/KVM + libvirt<\/strong><\/td><\/tr>
Ideal For<\/td>Developers testing OpenShift workloads locally<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

\u2705 System Requirements<\/h2>\n\n\n\n
Requirement<\/th>Value<\/th><\/tr><\/thead>
OS<\/td>Fedora, RHEL, CentOS, Ubuntu, Debian<\/td><\/tr>
CPU<\/td>Min 4 cores<\/td><\/tr>
RAM<\/td>Min 9 GB (16 GB recommended)<\/td><\/tr>
Disk Space<\/td>Min 35+ GB free<\/td><\/tr>
Virtualization<\/td>KVM\/QEMU enabled, libvirt installed<\/td><\/tr>
Pull Secret<\/td>Required from Red Hat account<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

\ud83e\uddf0 Step 1: Install Required Packages<\/h2>\n\n\n\n

\ud83d\udd39 Fedora \/ RHEL \/ CentOS:<\/h3>\n\n\n
sudo dnf install @virtualization libvirt libvirt-daemon-kvm qemu-kvm\nsudo systemctl enable --now libvirtd\nsudo usermod -a -G libvirt $(whoami)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
\ud83d\udd39 Ubuntu \/ Debian:<\/h3>\n\n\n
sudo apt update\nsudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager\nsudo systemctl enable --now libvirtd\nsudo usermod -aG libvirt $(whoami)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
\n
\ud83d\udd01 Logout and re-login<\/strong> to apply group changes.<\/p>\n<\/blockquote>\n\n\n\n
\n\n\n\n
\ud83d\udce5 Step 2: Download OpenShift Local (CRC) & Pull Secret<\/h2>\n\n\n\n
    \n
  1. Visit: https:\/\/console.redhat.com\/openshift\/create\/local<\/a><\/li>\n\n\n\n
  2. Sign in or register with a free Red Hat account.<\/li>\n\n\n\n
  3. Download:\n
      \n
    • Linux CRC archive<\/strong> (e.g. crc-linux-amd64.tar.xz<\/code>)<\/li>\n\n\n\n
    • Pull Secret<\/strong> and save it as pull-secret.txt<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n
      \ud83d\udce6 Step 3: Install the crc<\/code> Binary<\/h2>\n\n\n
      tar -xvf crc-linux-*.tar.xz\nsudo mv crc-linux-*\/crc \/u<\/span>sr\/local\/bin\/crc\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Check the version:<\/p>\n\n\n
      crc version\n<\/code><\/span><\/pre>\n\n\n
      \n\n\n\n
      \ud83d\udd27 Step 4: Setup the Cluster<\/h2>\n\n\n
      crc setup --pull-secret ~\/Downloads\/<\/span>pull-secret.txt\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n
      Replace the path to the actual location of your pull secret.<\/p>\n<\/blockquote>\n\n\n\n
      \n\n\n\n
      \u25b6\ufe0f Step 5: Start the OpenShift Cluster<\/h2>\n\n\n
      crc start\n<\/code><\/span><\/pre>\n\n\n
        \n
      • This initializes and boots the OpenShift VM<\/li>\n\n\n\n
      • Takes 5\u201315 minutes to fully start<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        \ud83c\udf10 Step 6: Access the Web Console<\/h2>\n\n\n\n
        After the cluster starts, it will output a URL like:<\/p>\n\n\n
        https:\/\/console-openshift-console.apps-crc.testing<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        Login Credentials:<\/h3>\n\n\n\n
        Role<\/th>Username<\/th>Password<\/th><\/tr><\/thead>
        Admin<\/td>kubeadmin<\/code><\/td>Printed in terminal output<\/td><\/tr>
        Developer<\/td>developer<\/code><\/td>developer<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Open the URL in your browser and login using the credentials.<\/p>\n\n\n\n
        \n\n\n\n
        \ud83e\uddea Step 7: Use the OpenShift CLI<\/h2>\n\n\n\n
        Configure CLI access:<\/h3>\n\n\n
        eval<\/span> $(crc oc-env)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        Login via CLI:<\/h3>\n\n\n
        oc login -u developer -p developer https:\/\/api.crc.testing:6443<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        You can now deploy workloads, create namespaces, and test apps locally.<\/p>\n\n\n\n
        \n\n\n\n
        \ud83d\udd01 Cluster Management Commands<\/h2>\n\n\n\n
        Action<\/th>Command<\/th><\/tr><\/thead>
        Stop cluster<\/td>crc stop<\/code><\/td><\/tr>
        Delete cluster<\/td>crc delete<\/code><\/td><\/tr>
        Check status<\/td>crc status<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \n\n\n\n
        \u26a0\ufe0f Common Issues & Fixes<\/h2>\n\n\n\n
        Issue<\/th>Fix<\/th><\/tr><\/thead>
        libvirt<\/code> permission errors<\/td>Ensure you are in the libvirt<\/code> group (groups<\/code> command)<\/td><\/tr>
        DNS resolution fails<\/td>Disable VPN or firewall; restart NetworkManager<\/td><\/tr>
        CRC start fails with bundle error<\/td>Use latest CRC version from Red Hat site<\/td><\/tr>
        No CRC command<\/td>Reboot OR ensure \/usr\/local\/bin<\/code> is in your PATH<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \n\n\n\n
        \ud83d\udcce Notes<\/h2>\n\n\n\n
          \n
        • CRC installs a single-node OpenShift cluster optimized for development.<\/li>\n\n\n\n
        • It’s not meant for production or multi-node use.<\/li>\n\n\n\n
        • Automatically sets up a VM using libvirt with a .crc<\/code> domain.<\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n
          <\/p>\n\n\n\n
          <\/p>\n","protected":false},"excerpt":{"rendered":"
          Here is the correct and updated step-by-step guide to install and configure OpenShift Local (formerly CRC \u2013 CodeReady Containers) on Linux laptops\/desktops for local development and testing. \ud83d\udc27 OpenShift Local… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[5153],"tags":[],"class_list":["post-49260","post","type-post","status-publish","format-standard","hentry","category-openshift"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49260","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49260"}],"version-history":[{"count":2,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49260\/revisions"}],"predecessor-version":[{"id":49264,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49260\/revisions\/49264"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49260"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49260"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49260"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}