Chapter 2. Installation

Procedure

1. Download the latest release of Red Hat OpenShift Local for your platform.
2. On Microsoft Windows, extract the contents of the archive.

3. On macOS or Microsoft Windows, run the guided installer and follow the instructions.

   Note

   On Microsoft Windows, you must install Red Hat OpenShift Local to your local C:\ drive. You cannot run Red Hat OpenShift Local from a network drive.

   On Red Hat Enterprise Linux, assuming the archive is in the ~/Downloads directory, follow these steps:

   1. Extract the contents of the archive:

      $ cd ~/Downloads
      $ tar xvf crc-linux-amd64.tar.xz

   2. Create the ~/bin directory if it does not exist and copy the crc executable to it:

      $ mkdir -p ~/bin
      $ cp ~/Downloads/crc-linux-*-amd64/crc ~/bin

   3. Add the ~/bin directory to your $PATH:

      $ export PATH=$PATH:$HOME/bin
      $ echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

Procedure

1. Download the latest release of Red Hat OpenShift Local.

2. Delete the existing Red Hat OpenShift Local instance:

   $ crc delete

   Warning

   The crc delete command results in the loss of data stored in the Red Hat OpenShift Local instance. Save any desired information stored in the instance before running this command.

3. Replace the earlier crc executable with the executable of the latest release. Verify that the new crc executable is in use by checking its version:

   $ crc version

4. Set up the new Red Hat OpenShift Local release:

   $ crc setup

5. Start the new Red Hat OpenShift Local instance:

   $ crc start