Chapter 20. Upgrade OpenShift Dev Spaces using the CLI management tool


Upgrade OpenShift Dev Spaces from the previous minor version using the CLI management tool to receive the latest bug fixes, security patches, and feature improvements. Upgrade the dsc management tool to version 3.28 by following the installation procedure to reinstall it before you begin.

Upgrade OpenShift Dev Spaces from the previous minor version using the CLI management tool to receive the latest bug fixes, security patches, and feature improvements.

Prerequisites

  • You have an administrative account on OpenShift.
  • You have a previous minor version of CodeReady Workspaces installed using the CLI management tool on the same instance of OpenShift, in the openshift-devspaces project.
  • You have dsc for OpenShift Dev Spaces version 3.28 installed. See Installing the dsc management tool.

Procedure

  1. Save and push changes back to the Git repositories for all running CodeReady Workspaces 3.27 workspaces.
  2. Shut down all workspaces in the CodeReady Workspaces 3.27 instance.
  3. Upgrade OpenShift Dev Spaces:

    $ dsc server:update -n openshift-devspaces
    Note

    For slow systems or internet connections, add the --k8spodwaittimeout=1800000 flag option to extend the Pod timeout period to 1800000 ms or longer.

Verification

  1. Navigate to the OpenShift Dev Spaces instance.
  2. The 3.28 version number is visible at the bottom of the page.

Upgrade Red Hat OpenShift Dev Spaces and perform minor version updates by using the CLI management tool in a restricted environment.

Prerequisites

Procedure

  1. Download and execute the mirroring script to install a custom Operator catalog and mirror the related images: prepare-restricted-environment.sh.

    $ bash prepare-restricted-environment.sh \
      --devworkspace_operator_index registry.redhat.io/redhat/redhat-operator-index:v4.22\
      --devworkspace_operator_version "v0.41.0" \
      --prod_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.22" \
      --prod_operator_package_name "devspaces" \
      --prod_operator_bundle_name "devspacesoperator" \
      --prod_operator_version "v3.28.0" \
      --my_registry "<my_registry>"

    where:

    <my_registry>
    The private Docker registry where the images are mirrored
  2. In all running workspaces in the CodeReady Workspaces 3.27 instance, save and push changes back to the Git repositories.
  3. Stop all workspaces in the CodeReady Workspaces 3.27 instance.
  4. Run the following command:

    $ dsc server:update --che-operator-image="$TAG" -n openshift-devspaces --k8spodwaittimeout=1800000

Verification

  1. Navigate to the OpenShift Dev Spaces instance.
  2. The 3.28 version number is visible at the bottom of the page.
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