Release Notes and Known Issues

Red Hat CodeReady Containers 1.6

Highlighted features and identified problems in CodeReady Containers 1.6

Red Hat Developer Group Documentation Team


This document lists and briefly describes new and improved features of CodeReady Containers 1.6. It also contains information about potential problems you may encounter while using the software. Where possible, workarounds are described for identified issues.

Part I. Release notes

This section documents the most important features and bug fixes in the CodeReady Containers 1.6 product.

Chapter 1. Component versions

CodeReady Containers 1.6 is shipped with the following versions of the main components:

Table 1.1. CodeReady Containers, Component versions


OpenShift Container Platform


OpenShift client binary (oc)


Chapter 2. Changes and improvements

This section highlights some of the notable changes introduced in CodeReady Containers 1.6.

2.1. New features

  • CodeReady Containers brings a minimal, preconfigured OpenShift Container Platform 4 cluster to your local laptop or desktop computer for development and testing purposes. CodeReady Containers is delivered as a Red Hat Enterprise Linux virtual machine that supports native hypervisors for Linux, macOS, and Microsoft Windows 10.

    • CodeReady Containers is designed for local development and testing on an OpenShift 4 cluster. To run an OpenShift 3 cluster locally, see Red Hat Container Development Kit.

2.1.1. Technology Previews

Support for these features falls under the Technology Preview Features Support Scope.

  • An experimental system tray is included in this release of CodeReady Containers for macOS. To enable the system tray, run the crc setup command with the --enable-experimental-features flag:

    $ crc setup --enable-experimental-features

2.1.2. Usability improvements

  • CodeReady Containers offers experimental support for running the crc binary behind a proxy.

2.2. Notable changes

  • CodeReady Containers 1.6 provides OpenShift Container Platform 4.3.0 as the embedded OpenShift version.
  • The --vm-driver flag has been removed. CodeReady Containers only supports native hypervisors.

Part II. Known issues

This section describes issues that users of CodeReady Containers 1.6 may encounter, as well as possible workarounds for these issues.

Chapter 3. General issues

Issues affecting all supported platforms.

3.1. Embedded certificates expire after 30 days

Each released crc binary includes an embedded system bundle that expires 30 days after the release due to certificates embedded in the OpenShift cluster.

Certificate recovery is automatic, but will add approximately three minutes to the start time of the CodeReady Containers virtual machine.

3.2. Metrics are disabled by default

To ensure CodeReady Containers can run on a typical laptop, some resource-heavy services are disabled by default. One of these services is Prometheus and all of the related monitoring, alerting, and telemetry functionality.

Enabling these features will require more resources than the CodeReady Containers virtual machine uses by default.

Chapter 4. Issues on macOS

This section describes CodeReady Containers issues that affect users on a macOS host.

4.1. The experimental system tray must be manually uninstalled

To remove the system tray:

  1. Unload the launched scripts:

    $ launchctl unload ~/Library/LaunchAgents/crc.daemon.plist
    $ launchctl unload ~/Library/LaunchAgents/crc.tray.plist
  2. Delete the launched scripts:

    $ rm ~/Library/LaunchAgents/crc.daemon.plist
    $ rm ~/Library/LaunchAgents/crc.tray.plist

Chapter 5. Issues on Microsoft Windows

This section describes CodeReady Containers issues that affect users on a Microsoft Windows host.

5.1. Unexpected behavior when run outside of %WINDRIVE%

The Hyper-V driver will fail when the crc binary is executed from a network drive. The crc binary must be placed in a location on %WINDRIVE%. %WINDRIVE% is normally set to C:\.

5.2. CodeReady Containers expects FullLanguage support in PowerShell

The ConstrainedLanguage PowerShell mode is supported with exceptions determined by your system administrator.

Additional resources

Legal Notice

Copyright © 2020 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.