hurzelpurzel / crc

crc is a tool to run containers. It manages a local OpenShift 4.x cluster or a Podman VM optimized for testing and development purposes

CRC - Runs Containers

• Introduction
• Usage data
• Documentation
• Community

Introduction

crc is a tool to run containers. It manages a local OpenShift 4.x cluster, OKD cluster or a Podman VM optimized for testing and development purposes.

If you are looking for a solution for running OpenShift 3.x, you will need tools such as oc cluster up, Minishift or CDK.

Usage data

The first time CRC is run, you will be asked to opt-in to Red Hat’s telemetry collection program.

With your approval, CRC collects pseudonymized usage data and sends it to Red Hat servers to help improve our products and services. Read our privacy statement to learn more about it. For the specific data points being collected, see Usage data.

Manually configuring usage data collection

You can manually change your preference about usage data collection by running crc config set consent-telemetry <yes/no> before the next crc start.

Documentation

Getting CRC

CRC binaries with an embedded OpenShift disk image can be downloaded from this page.

Using CRC

The documentation for CRC is currently hosted by GitHub Pages.

See the CRC Getting Started Guide.

Building the documentation

You can find the source files for the documentation in the docs/source directory.

To build the formatted documentation, install podman then use the following:

$ git clone https://github.com/crc-org/crc
$ cd crc
$ make build_docs

This will create a docs/build/master.html file which you can view in your browser.

Developing CRC

Developers who want to work on CRC should visit the Developing CRC document.

Community

Contributions, questions, and comments are all welcomed and encouraged!

You can reach the community by:

• Joining the #codeready channel on Freenode IRC

If you want to contribute, make sure to follow the contribution guidelines when you open issues or submit pull requests.