{"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":"2026-06-23T06:59:18","modified_gmt":"2026-06-23T06:59:18","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\n<\/code><\/span><\/pre>\n\n
        <\/code><\/span><\/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 -p ~\/Downloads\/<\/span>pull-secret.txt\nor\ncrc start --pull-secret-file ~\/Downloads\/<\/span>pull-secret.txt\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/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
            rajesh@DM-GYK3HC26H7 ~ % crc start --pull-secret-file ~\/Downloads\/pull-secret.txt\nINFO Using bundle path \/Users\/rajesh\/.crc\/cache\/crc_vfkit_4.21<\/span>.14<\/span>_arm64.crcbundle \nINFO Checking if<\/span> running macOS version >= 13.<\/span>x    \nINFO Checking if<\/span> running as<\/span> non-root              \nINFO Checking if<\/span> crc-admin-helper executable is cached \nINFO Checking if<\/span> running on a supported CPU architecture \nINFO Checking if<\/span> crc executable symlink exists    \nINFO Checking minimum RAM requirements            \nINFO Checking if<\/span> running emulated on Apple silicon \nINFO Checking if<\/span> vfkit is installed               \nINFO Checking if<\/span> old launchd config for<\/span> tray and<\/span>\/or<\/span> daemon exists \nINFO Checking if<\/span> crc daemon plist file is present and<\/span> loaded \nINFO Checking SSH port availability               \nINFO Loading bundle: crc_vfkit_4.21<\/span>.14<\/span>_arm64...   \nINFO Starting CRC VM for<\/span> openshift 4.21<\/span>.14<\/span>...     \nINFO CRC instance is running with IP 127.0<\/span>.0<\/span>.1<\/span>    \nINFO CRC VM is running                            \nINFO Updating authorized keys...                  \nINFO Configuring shared directories               \nINFO Check internal and<\/span> public<\/span> DNS query...       \nINFO Check DNS query from host...                 \nINFO Verifying validity of the kubelet certificates... \nINFO Starting kubelet service                     \nINFO Waiting for<\/span> kube-apiserver availability... [takes around 2<\/span>min] \nINFO Adding user's pull secret to the cluster...  \nINFO Updating SSH key to machine config resource... \nINFO Overriding password for developer user       \nINFO Changing the password for the users          \nINFO Updating cluster ID...                       \nINFO Updating root CA cert to admin-kubeconfig-client-ca configmap... \nINFO Starting openshift instance... [waiting for the cluster to stabilize] \nINFO 6 operators are progressing: console, dns, image-registry, ingress, openshift-controller-manager, ... \nINFO 3 operators are progressing: authentication, network, openshift-controller-manager \nINFO All operators are available. Ensuring stability... \nINFO Operators are stable (2\/3)...                \nINFO Operators are stable (3\/3)...                \nINFO Waiting until the user'<\/span>s pull secret is written to the instance disk... \nINFO Adding crc-admin and<\/span> crc-developer contexts to kubeconfig... \nStarted the OpenShift cluster.\n\nThe server is accessible via web console at:\n  https:\/\/console-openshift-console.apps-crc.testing<\/span>\n\nLog in as<\/span> administrator:\n  Username: kubeadmin\n  Password: j33RY-Xxx9Z-bbgUw-FzkaB\n\nLog in as<\/span> user:\n  Username: developer\n  Password: developer\n\nUse<\/span> the<\/span> 'oc<\/span>' command<\/span> line<\/span> interface<\/span>:\n  $ eval<\/span> $(crc<\/span> oc<\/span>-env<\/span>)\n  $ oc<\/span> login<\/span> -u<\/span> developer<\/span> https<\/span>:\/\/api<\/span>.crc<\/span>.testing<\/span>:6443\nrajesh<\/span>@DM<\/span>-GYK3HC26H7<\/span> ~ % \n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
            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… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","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":5,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49258\/revisions"}],"predecessor-version":[{"id":77160,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49258\/revisions\/77160"}],"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}]}}