Install OpenShift Local on your own computer

The next page has a section "Download what you need to get started". Make sure that Windows is selected in the dropdown, then click the Download OpenShift Local button.

Extract the OpenShift Local compressed zip file into the Downloads directory in the Command Prompt.

tar -xf %USERPROFILE%\Downloads\crc-windows-installer.zip ^
  -C %USERPROFILE%\Downloads\

From the Command Prompt, run the OpenShift Local MSI installer.

%USERPROFILE%\Downloads\crc-windows-amd64.msi

1. Click Next.
2. Read the license agreement, then click I accept the terms in the License Agreement, then click the Next button.
3. Click the Install button.
4. Windows Administrator privileges required
   Configuring OpenShift Local requires Administrator privileges to your system to configure it's virtual machine configuration and networking.
   Click the Yes button to continue.
   Then click the Yes button to continue.
5. When completed, click the Finish button.
6. Then click the Reboot button to reboot your computer.

To effectively configure OpenShift Local, you need to understand the amount of CPUs, memory, and storage on your computer. Use the command below in Command Prompt to display the amount of system resources in your computer.

systeminfo | findstr /C:"Total Physical Memory"

Use the command below in Command Prompt to display the amount of logical processors in your computer.

echo %NUMBER_OF_PROCESSORS%

• For cpus:
  I recommend subtracting your total number of CPUs by 1.
• For memory:
  I recommend reserving your 90% of your total memory for OpenShift Local, but you can do more or less if you wish. Multiply by 90% of your total memory, and I divide by 1000 to get the total memory in MB, which is normally shown in kB.
• For disk-size:
  I recommend at least 400GiB, but if you don't actually have that much space, it's ok. The disk automatically grows dynamically over time, as data is persisted.

Now configure the CPUs of OpenShift Local with the crc command.

set /a CRC_CPUS=%NUMBER_OF_PROCESSORS%-1 && crc config set cpus %CRC_CPUS%

Now configure the memory of OpenShift Local with the crc command.

for /f "tokens=4" %a in ('systeminfo ^| findstr /C:"Total Physical Memory"') do set STR_MEMORY=%a
set "TOTAL_MEMORY=%STR_MEMORY:,=%"
set /A MULTIPLY_MEMORY="%TOTAL_MEMORY%*90"
set SET_MEMORY=%MULTIPLY_MEMORY:~0,-3%
crc config set memory %SET_MEMORY%0

Now configure the disk-size of OpenShift Local with the crc command.

crc config set disk-size 400

The next page has a section "Download what you need to get started". Make sure that Linux is selected in the dropdown, then click the Download OpenShift Local button.

install -d ~/.local/bin/

tar xvf \
  ~/Downloads/crc-linux-amd64.tar.xz \
  --strip-components=1 \
  -C ~/.local/bin/ \
  crc-linux-*-amd64/crc

To effectively configure OpenShift Local, you need to understand the amount of CPUs, memory, and storage on your computer. Use the command below to display the amount of system resources in your Terminal.

echo "scale=0; $(grep MemTotal \
  /proc/meminfo | awk \
  '{print $2}') / 1000" | bc \
  | { read -r prefix; echo "${prefix}MiB memory"; }
echo "$(nproc) logical processors"

• For cpus:
  I recommend subtracting your total number of CPUs by 1.
• For memory:
  I recommend reserving your 90% of your total memory for OpenShift Local, but you can do more or less if you wish. Multiply by 90% of your total memory, and I divide by 1000 to get the total memory in MB, which is normally shown in kB.
• For disk-size:
  I recommend at least 400GiB, but if you don't actually have that much space, it's ok. The disk automatically grows dynamically over time, as data is persisted.

Now configure the CPUs of OpenShift Local with the crc command.

crc config set cpus $(($(nproc) - 1))

Now configure the memory of OpenShift Local with the crc command.

crc config set memory $(echo \
  "scale=0; $(grep MemTotal \
  /proc/meminfo | awk \
  '{print $2}') * 0.9 / 1000" | bc)

Now configure the disk-size of OpenShift Local with the crc command.

crc config set disk-size 400

• Click the ? button in the top right.
• Click Command Line Tools.
• Click Download oc for Windows for x86_64.
• Accept another self-signed certificate for downloads.
• Extract the oc command in your Terminal.

• tar -xf %USERPROFILE%\Downloads\oc.zip ^
    -C %USERPROFILE%\AppData\Local\Microsoft\WindowsApps\

• Log into your OpenShift Local cluster in the Command Prompt using the oc command. You need to find the kubeadmin password provided when you started OpenShift Local with the crc start command and paste it after -p.

• oc login https://api.crc.testing:6443 -u kubeadmin -p 

• Click the ? button in the top right.
• Click Command Line Tools.
• Click Download oc for Linux for x86_64.
• Accept another self-signed certificate for downloads.
• Extract the oc command in your Terminal.

• tar xvf ~/Downloads/oc.tar \
    -C ~/.local/bin/

• Log into your OpenShift Local cluster in the Command Prompt using the oc command. You need to find the kubeadmin password provided when you started OpenShift Local with the crc start command and paste it after -p.

• oc login https://api.crc.testing:6443 -u kubeadmin -p