Chapter 5. Upgrading CodeReady Workspaces


This chapter describes how to upgrade a CodeReady Workspaces instance to CodeReady Workspaces 2.1.

This section describes how to upgrade from CodeReady Workspaces 2.0 to CodeReady Workspaces 2.1 on OpenShift 4 using the OpenShift web console. This method is using the Operator from OperatorHub.

Prerequisites

  • An administrator account on an OpenShift 4 instance.
  • An instance of CodeReady Workspaces 2.0, running on the same instance of OpenShift 4, installed using an Operator from OperatorHub.

Procedure

  1. Open the OpenShift web console.
  2. Navigate to the Operators Installed Operators section.
  3. Click Red Hat CodeReady Workspaces in the list of installed operators.
  4. Navigate to the Subscription tab and enable the following options:

    • Channel: latest
    • Approval: Automatic

Verification steps

  1. Log in to the CodeReady Workspaces instance.
  2. The 2.1 version number is visible at the bottom of the page.

This section describes how to upgrade from CodeReady Workspaces 2.0 to CodeReady Workspaces 2.1 on OpenShift 3 using the CLI management tool.

Prerequisites

  • An administrative account on an OpenShift 3 instance.
  • A running instance of Red Hat CodeReady Workspaces running on OpenShift 3, installed using the CLI management tool.
  • The crwctl management tool installed.

Procedure

  1. In all running workspaces in the CodeReady Workspaces 2.0 instance, save and push changes to Git repositories.
  2. Run the following command:

    $ crwctl server:update

Verification steps

  1. Log in to the CodeReady Workspaces instance.
  2. The 2.1 version number is visible at the bottom of the page.

This sections describes how to perform an upgrade from the previous major version of Red Hat CodeReady Workspaces (1.2).

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top