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

Here is the step-by-step guide<\/strong> to correctly install and configure OpenShift Local (CRC)<\/strong> on macOS laptops or desktops<\/strong> for local OpenShift 4.x development.<\/p>\n\n\n\n

\n\n\n\n

\ud83c\udf4e OpenShift Local on macOS \u2013 Overview<\/h2>\n\n\n\n
Feature<\/th>Description<\/th><\/tr><\/thead>
Tool Name<\/td>OpenShift Local (CLI tool: crc<\/code>)<\/td><\/tr>
Runs<\/td>Single-node OpenShift 4.x cluster<\/td><\/tr>
Virtualization<\/td>Uses Apple\u2019s Hypervisor.framework<\/strong> (no VirtualBox required)<\/td><\/tr>
Use Case<\/td>Ideal for local development<\/strong>, testing OpenShift apps, and CLI practice<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

\u2705 System Requirements<\/h2>\n\n\n\n
Requirement<\/th>Minimum (Recommended)<\/th><\/tr><\/thead>
OS<\/td>macOS Monterey (12.x) or later<\/td><\/tr>
CPU<\/td>4 cores<\/td><\/tr>
RAM<\/td>9 GB (16 GB recommended)<\/td><\/tr>
Disk Space<\/td>35+ GB free<\/td><\/tr>
Virtualization<\/td>Must be enabled (Apple Silicon\/Intel supported)<\/td><\/tr>
Tools Included<\/td>crc<\/code>, oc<\/code> (OpenShift CLI), VM image<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

\ud83e\uddf0 Step 1: Download OpenShift Local & 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 with your Red Hat account<\/strong> (create a free one if needed).<\/li>\n\n\n\n
  3. Download:\n
      \n
    • openshift-local.pkg<\/code> (installer for macOS)<\/li>\n\n\n\n
    • Pull Secret<\/strong> file \u2192 Save it as pull-secret.txt<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n

      \ud83d\udcbb Step 2: Install OpenShift Local (CRC)<\/h2>\n\n\n\n
        \n
      1. Double-click openshift-local.pkg<\/code> to begin the installation.<\/li>\n\n\n\n
      2. Follow the macOS installer prompts.<\/li>\n\n\n\n
      3. After installation, open Terminal and verify:<\/li>\n<\/ol>\n\n\n
        crc version\n<\/code><\/span><\/pre>\n\n\n
        You should see the version (e.g., 2.49.0<\/code>) and OpenShift version (e.g., 4.18.x<\/code>).<\/p>\n\n\n\n
        \n\n\n\n
        \ud83d\udd27 Step 3: Set Up the Cluster<\/h2>\n\n\n\n
        In Terminal:<\/p>\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 if your pull-secret is stored elsewhere.<\/p>\n<\/blockquote>\n\n\n\n
        This command:<\/p>\n\n\n\n
          \n
        • Sets up the Hypervisor VM<\/li>\n\n\n\n
        • Prepares OpenShift environment<\/li>\n\n\n\n
        • Installs the CRC bundle<\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n
          \u25b6\ufe0f Step 4: Start the OpenShift Cluster<\/h2>\n\n\n\n
          Run:<\/p>\n\n\n
          crc start\n<\/code><\/span><\/pre>\n\n\n
            \n
          • This launches a single-node OpenShift 4 cluster.<\/li>\n\n\n\n
          • The process may take 5\u201315 minutes depending on your hardware.<\/li>\n\n\n\n
          • Once done, you\u2019ll see:<\/li>\n<\/ul>\n\n\n
            Started the OpenShift cluster\nConsole URL: 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
            \n\n\n\n
            \ud83c\udf10 Step 5: Access OpenShift Web Console<\/h2>\n\n\n\n
            Open the printed URL:<\/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>Shown in terminal<\/td><\/tr>
            Developer<\/td>developer<\/code><\/td>developer<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
            \n\n\n\n
            \ud83e\uddea Step 6: Access via oc<\/code> CLI (Optional)<\/h2>\n\n\n\n
            To set up the OpenShift CLI environment:<\/p>\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
            Then login:<\/p>\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
            Now you can deploy, test, and manage apps from your terminal.<\/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>
            Status<\/td>crc status<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
            \n\n\n\n
            \u26a0\ufe0f Troubleshooting Tips<\/h2>\n\n\n\n
            Issue<\/th>Fix<\/th><\/tr><\/thead>
            DNS resolution fails<\/td>Disable VPN; retry browser or oc<\/code> with correct URL<\/td><\/tr>
            CRC fails to start<\/td>Check RAM\/CPU availability and make sure no conflicting VMs<\/td><\/tr>
            crc<\/code> command not found<\/td>Reboot or re-add \/usr\/local\/bin<\/code> to your shell $PATH<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
            \n\n\n\n
            <\/p>\n","protected":false},"excerpt":{"rendered":"
            Here is the step-by-step guide to correctly install and configure OpenShift Local (CRC) on macOS laptops or desktops for local OpenShift 4.x development. \ud83c\udf4e OpenShift Local on macOS \u2013 Overview… <\/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-49258","post","type-post","status-publish","format-standard","hentry","category-openshift"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49258","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=49258"}],"version-history":[{"count":2,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49258\/revisions"}],"predecessor-version":[{"id":49263,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49258\/revisions\/49263"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49258"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49258"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49258"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}