{"id":49295,"date":"2025-05-05T15:28:18","date_gmt":"2025-05-05T15:28:18","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49295"},"modified":"2025-07-12T05:54:57","modified_gmt":"2025-07-12T05:54:57","slug":"openshift-admin-how-to-add-node-to-the-cluster-in-openshift-local","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/openshift-admin-how-to-add-node-to-the-cluster-in-openshift-local\/","title":{"rendered":"Openshift Admin: How to add node to the cluster in openshift Local"},"content":{"rendered":"\n<p>To <strong>add a node to an OpenShift cluster running locally<\/strong> using OpenShift Local (previously known as CodeReady Containers or CRC), the process involves configuring a multi-node cluster in OpenShift Local. However, <strong>OpenShift Local is designed for single-node clusters<\/strong> primarily for development and testing purposes. It doesn&#8217;t natively support multi-node setups as part of the CRC deployment. That said, you can try a few different approaches to simulate a multi-node setup.<\/p>\n\n\n\n<p>Here&#8217;s a high-level guide on how to simulate adding additional nodes or a multi-node environment with OpenShift Local:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Option 1: Use OpenShift in a Virtual Machine for Multi-Node Setup<\/h3>\n\n\n\n<p>If you require multiple nodes for testing, a good approach is to deploy <strong>OpenShift in a virtualized environment<\/strong> (e.g., using <code>minikube<\/code> or <code>Vagrant<\/code>).<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Using Minikube (for Multi-Node Simulation)<\/h4>\n\n\n\n<p>Minikube is a tool that allows you to run a multi-node OpenShift cluster on your local machine (even if OpenShift Local is a single-node setup).<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Install Minikube<\/strong> if you haven\u2019t already:\n<ul class=\"wp-block-list\">\n<li>Follow the instructions here: <a href=\"https:\/\/minikube.sigs.k8s.io\/docs\/\" target=\"_blank\" rel=\"noopener\">https:\/\/minikube.sigs.k8s.io\/docs\/<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Start a multi-node OpenShift cluster<\/strong>:<br>You can simulate a multi-node cluster using Minikube with a configuration for multiple nodes: <code>minikube start --nodes 3 --driver=virtualbox<\/code> In this setup, Minikube will create a multi-node Kubernetes\/OpenShift-like environment that you can use to simulate adding nodes. OpenShift will be deployed on a VM, and the control plane and worker nodes will be simulated.<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Using OpenShift in VirtualBox (for Development)<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Download OpenShift Installer<\/strong> from Red Hat:<br><a href=\"https:\/\/www.openshift.com\/\" target=\"_blank\" rel=\"noopener\">OpenShift CLI (oc)<\/a>.<\/li>\n\n\n\n<li><strong>Create Virtual Machines<\/strong>: You can use VirtualBox (or any hypervisor) to manually create nodes. Each VM can be configured as a control plane or worker node.<\/li>\n\n\n\n<li><strong>Set up OpenShift using the <code>openshift-install<\/code> tool<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Install OpenShift manually by using the OpenShift installer.<\/li>\n\n\n\n<li>Choose a manual installation process for multi-node clusters.<\/li>\n\n\n\n<li>Follow official OpenShift documentation for setting up a local multi-node environment.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Option 2: Use OpenShift for Developers (Single Node Local Cluster Simulation)<\/h3>\n\n\n\n<p>In case your requirement is only for testing or development on a <strong>single-node cluster<\/strong>, OpenShift Local (CRC) is suitable. You cannot directly add additional nodes to a CRC setup, as it&#8217;s designed to be a minimal, local environment.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Steps for CRC Setup:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Download and Install CRC<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Follow the steps in the <a href=\"https:\/\/developers.redhat.com\/products\/codeready-containers\/overview\" target=\"_blank\" rel=\"noopener\">official OpenShift CRC documentation<\/a>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Start CRC Cluster<\/strong>:\n<ul class=\"wp-block-list\">\n<li>After installation, run: <code>crc start<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Access OpenShift Dashboard<\/strong>:\n<ul class=\"wp-block-list\">\n<li>The <code>crc<\/code> setup will give you access to a fully functional OpenShift environment on a single node via <code>oc<\/code> and a web console.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Verify Node<\/strong>:<ul><li>Check the current node in the CRC environment: <code>oc get nodes<\/code><\/li><\/ul>You will see that it is running a single node.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Option 3: OpenShift 4.x &#8211; Use <code>oc<\/code> to simulate nodes (limited)<\/h3>\n\n\n\n<p>In <strong>OpenShift 4.x<\/strong> or <strong>higher<\/strong>, you can simulate multi-node configurations by using <strong>multi-architecture clusters<\/strong> with specific configurations. This is more of a testbed setup and is not typical for production.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">Option 4: Deploy OpenShift with <code>openshift-installer<\/code><\/h3>\n\n\n\n<p>If your requirements extend beyond a local developer environment and you want to create a more robust cluster on your local machines, you can use <strong><code>openshift-installer<\/code><\/strong> to deploy OpenShift in a multi-node configuration, but this typically requires a more complex local setup.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Use the OpenShift Installer<\/strong> to configure a <strong>bare-metal<\/strong> or <strong>VM-based<\/strong> cluster.<\/li>\n\n\n\n<li>Set up your <strong>control plane<\/strong> and <strong>worker nodes<\/strong> as separate machines or VMs.<\/li>\n\n\n\n<li>After the cluster is set up, you can <strong>add worker nodes<\/strong> using the OpenShift Installer:\n<ul class=\"wp-block-list\">\n<li>You can add worker nodes by manually modifying the inventory file used by the installer.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">Summary<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>OpenShift Local (CRC)<\/strong> is designed for <strong>single-node environments<\/strong> for local development and testing. You can&#8217;t natively add more nodes to the same CRC cluster.<\/li>\n\n\n\n<li>For a <strong>multi-node setup<\/strong>, consider using tools like <strong>Minikube<\/strong> or <strong>OpenShift Installer<\/strong> on virtualized environments or physical machines.<\/li>\n<\/ul>\n\n\n\n<p>Would you like further clarification or assistance with setting up a multi-node simulation using any of these methods?<\/p>\n","protected":false},"excerpt":{"rendered":"<p>To add a node to an OpenShift cluster running locally using OpenShift Local (previously known as CodeReady Containers or CRC), the process involves configuring a multi-node cluster in OpenShift Local&#8230;. <\/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-49295","post","type-post","status-publish","format-standard","hentry","category-openshift"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49295","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=49295"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49295\/revisions"}],"predecessor-version":[{"id":49296,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49295\/revisions\/49296"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49295"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49295"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49295"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}