Release notes and known issues


Red Hat OpenShift Dev Spaces 3.26

Release notes and known issues for Red Hat OpenShift Dev Spaces 3.26

Gaurav Trivedi

Red Hat Developer Group Documentation Team

Abstract

Information about new and noteworthy features as well as known issues in Red Hat OpenShift Dev Spaces 3.26.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Chapter 1. About Red Hat OpenShift Dev Spaces

Red Hat OpenShift Dev Spaces provides web-based development environments on Red Hat OpenShift with an enterprise-level setup:

  • Cloud Development Environments (CDE) server
  • IDEs such as Microsoft Visual Studio Code - Open Source, and JetBrains desktop IntelliJ IDEA Ultimate, PyCharm, WebStorm, RubyMine, CLion, GoLand, PhpStorm, and Rider editors.
  • Containerized environments with popular programming languages, frameworks, and Red Hat technologies

Red Hat OpenShift Dev Spaces is well-suited for container-based development.

Red Hat OpenShift Dev Spaces 3.26 is based on Eclipse Che 7.113.

1.1. Supported platforms

OpenShift Dev Spaces runs on OpenShift 4.15–4.21 on the following CPU architectures:

  • AMD64 and Intel 64 (x86_64)
  • IBM Z (s390x)
  • IBM Power (ppc64le)
  • ARMv8 (arm64)

1.2. Support policy

For Red Hat OpenShift Dev Spaces 3.26, Red Hat will provide support for deployment, configuration, and use of the product.

There are some differences between Red Hat OpenShift Dev Spaces and the upstream project on which it is based, Eclipse Che:

  • OpenShift Dev Spaces is supported only on Red Hat OpenShift.
  • OpenShift Dev Spaces is based on Red Hat Enterprise Linux and is regularly updated to include the latest security fixes.
  • OpenShift Dev Spaces provides getting-started samples supported in the air-gap mode with languages and technologies such as Quarkus, Lombok, NodeJS, Python, DotNet, Golang, and C/C++. Community samples are available at the Devfile registry page.
  • OpenShift Dev Spaces uses OpenShift OAuth for user login and management.

Red Hat provides licensing and packaging to ensure enterprise-level support for OpenShift Dev Spaces.

Chapter 2. New features and enhancements

With this release, the Choose an Editor view on the user dashboard is improved. Editors are now neatly grouped and sorted to provide better usability and a more organized selection process.

This update ensures that you can quickly find and select your preferred development environment from the available grouped options.

Additional resources

With this release, you can set maximum resource limits and requests for workspace containers by using the spec.DevWorkspace.containerResourceCaps field in the CheCluster custom resource (CR). This update ensures that you do not create workspaces with excessive CPU or memory requirements at the devfile level.

Additional resources

With this release, you can rename your workspaces directly from the Overview tab in the dashboard. This update introduces a consistent user experience by using a new reusable copy-to-clipboard component.

You can edit a workspace name when the workspace is in the Stopped or Failed state. The dashboard validates new names for length, naming patterns, and duplicates to ensure accuracy before you save your changes.

Additional resources

2.4. Improved PVC full error handling

With this release, per-user storage error handling is improved through new persistent volume claim (PVC) error detection and guided recovery steps. If a workspace fails to start because the PVC storage is full, you see a clear error message that identifies the workspace name and the root cause.

The guided recovery provides a direct link to the OpenShift Console PVC management view and a YAML snippet to help you expand the PVC manually. These steps ensure that you can resolve storage issues quickly to restart your workspace.

Additional resources

The che-code editor, which is based on Visual Studio Code - Open Source (Code - OSS), is now updated to version 1.104.3.

For more infomation, see link"https://code.visualstudio.com/updates/v1_104[VS Code release notes].

Additional resources

With this release, the landing page for connecting to a workspace by using VS Code (SSHD) is improved. The update enhances the presentation with better styling and adds copy-to-clipboard functionality for commands and configuration snippets.

The landing page now includes direct links for required tools and authentication. Additionally, the instructions provide guidance for Windows users where applicable, ensuring a smoother connection process across different operating systems.

Additional resources

The DevWorkspace Operator component is updated to version 0.39.0. This version provides important fixes and enhancements to Dev Spaces.

For more information, see the DevWorkspace Operator changelog.

Additional resources

With this release, the Downloading IDE binaries…​ (it can take a few minutes) message is displayed only when it is relevant.

This message no longer appears on the Starting workspace page for the default VS Code editor. This update ensures that you receive accurate information about the workspace startup process and avoids unnecessary confusion. 

Additional resources

Chapter 3. Bug fixes

3.1. Updated branding for better user experience

With this release, custom logo rendering on the user dashboard is improved. This update resolves an issue where base64-encoded images appeared blurry and ensures that images remain sharp on the loading page.

The dashboard now supports multiple image formats, including JPG, PNG, GIF, WebP, and SVG. Additionally, this update introduces dynamic loader image selection and includes a "Loading…​" fallback for SVG files to ensure a smooth visual experience.

Additional resources

An issue is resolved where project cloning failed when you defined custom getting-started samples by using an SSH URL for the Git repository. Previously, attempting to launch a custom sample with an SSH URL resulted in a 403 error during the cloning process.

With this fix, you can successfully launch custom samples that use SSH URLs. This update ensures a consistent workspace creation flow when you use custom sample configurations.

Additional resources

3.3. Improved authorization error message

Before this update, advanced authorization errors displayed an unhelpful "Error [object Object]" message. As a consequence, users could not determine the cause of authorization failures. With this release, the proper authorization error message is displayed. As a result, you receive clear and actionable information about authorization issues.

Additional resources

An issue is resolved where the Save button was not correctly disabled in the User Preferences section of the dashboard. When Git configuration settings are already applied, the Save button is now correctly disabled.

This fix ensures consistent dashboard behavior when you refresh the page or switch between different preference tabs.

Additional resources

Before this update, the Close and Stop button did not always stop the active Dev Workspace. As a consequence, workspaces could continue running after the IDE was closed. With this release, the button behavior is corrected to ensure proper workspace termination. As a result, closing the IDE reliably stops the associated workspace.

Additional resources

Before this update, long-running tasks in terminals did not prevent workspace idle termination. As a consequence, workspaces could shut down while important processes were still executing. With this release, tools running in terminals are properly detected and prevent workspace idling. As a result, long-running terminal tasks complete without interruption.

Additional resources

Chapter 4. Technology Preview

Technology Preview features provide early access to upcoming product innovations, enabling you to test functionality and provide feedback during the development process. However, these features are not fully supported under Red Hat Subscription Level Agreements, may not be functionally complete, and are not intended for production use. As Red Hat considers making future iterations of Technology Preview features generally available, we will attempt to resolve any issues that customers experience when using these features. See: Technology Preview support scope.

4.1. Kiro SSH local-to-remote support

Red Hat OpenShift Dev Spaces now includes native support for the Kiro editor as a local-to-remote SSH IDE. This update introduces a dedicated editor definition tile in the dashboard, allowing you to connect a local Kiro desktop application directly to running workspaces.

Known issues

The Kiro desktop application (version 0.8.206) might encounter a connection error after you sign in with a Google account. The error message indicates "Too many authentication failures," and logs show that all configured authentication methods failed.

  • For authentication failures, check the SSHD logs at /tmp/sshd.log within the DevWorkspace development container.

Workaround

Sign in to the Kiro desktop application by using an AWS Builder ID instead of a Google account.

Important

Connecting to a remote workspace by using a local Kiro (desktop) editor is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information about the support scope of Red Hat Technology Preview features, see the Technology Preview Features Support Scope documentation.

Additional resources

Chapter 5. Deprecated functionalities

None.

Chapter 6. Removed functionalities

None.

Chapter 7. Known issues

The Red Hat OpenShift Dev Spaces Operator does not currently support OpenShift clusters configured with Bring Your Own (BYO) External Authentication.

Dev Spaces currently relies on the built-in OpenShift OAuth server. Configurations that replace the built-in OAuth server with external corporate OIDC Identity Providers (IdPs) are not supported in this release.

Additional resources

There is a known issue with the desktop version of Visual Studio Code editor. Workspaces using these editor ignore idling timeouts specified by CheCluster properties such as secondsOfRunBeforeIdling and secondsOfInactivityBeforeIdling. There is currently no workaround available.

Additional resources

7.3. "504 Gateway Time-out" error

There is a known issue affecting the use of IntelliJ IDEA Ultimate IDE on the arm64 architecture. When you start a workspace in the IDE, the following error message appears: "504 Gateway Time-out". There is no workaround available.

Additional resources

7.4. "PostStartHook failed" error

There is a known issue with using the Ansible sample on the `arm64`architecture. The Ansible sample fails to start and the following error message appears: "Error creating DevWorkspace deployment: Detected unrecoverable event FailedPostStartHook: PostStartHook failed." There is no workaround available.

Additional resources

There is a known issue where the .NET sample fails to start on the arm64 architecture because there is no quay.io/devspaces/dotnet-90 image available for arm64. There is no workaround available.

Additional resources

There is a known issue affecting workspaces in Dev Spaces deployed to OpenShift Platform 4.18. When you start the workspace, the following error message appears: "Error creating DevWorkspace deployment: Container tools has state ImagePullBackOff".

Workaround

  • Restart the workspace.

Additional resources

There is currently a known issue affecting the use of the desktop versions of JetBrains IDEs with IBM Power, and IBM Z architectures. The downloaded JetBrains IDE binaries are not multi-arch, causing workspace startup to fail. There is currently no workaround available.

Additional resources

There is a known issue when experimental refresh token mode is applied using the CHE_FORCE_REFRESH_PERSONAL_ACCESS_TOKEN property for the GitHub and Microsoft Azure DevOps OAuth providers. This causes the workspace starts to reload the dashboard cyclically, creating a new personal access token on each page restart. The refresh token mode works correctly for 'GitLab' and 'BitBucket' OAuth providers.

Additional resources

Chapter 8. Frequently asked questions

Is it possible to deploy applications from OpenShift Dev Spaces to an OpenShift cluster?
OpenShift user token is automatically injected into workspace containers which makes it possible to run oc CLI commands against OpenShift cluster.
For best performance, what is the recommended storage to use for Persistent Volumes used with OpenShift Dev Spaces?
Use block storage.
Is it possible to deploy more than one OpenShift Dev Spaces instance on the same cluster?
Only one OpenShift Dev Spaces instance can be deployed per cluster.
Is it possible to install OpenShift Dev Spaces offline (that is, disconnected from the internet)?
See Installing Red Hat OpenShift Dev Spaces in restricted environments on OpenShift.
Is it possible to use non-default certificates with OpenShift Dev Spaces?
You can use self-signed or public certificates. See Importing untrusted TLS certificates.
Is it possible to run multiple workspaces simultaneously?
See Enabling users to run multiple workspaces simultaneously.
Is it possible to configure OpenShift Dev Spaces to use open-vsx.org?

Yes, but this is not the default configuration. While you can connect to the public Open VSX Registry, consider these factors:

  • Service limits: API usage is organized into defined tiers. The Eclipse Foundation implements these limits to protect infrastructure from high-frequency automated traffic and to provide consistent service quality for all users. For more information, see Rate Limits and Usage Tiers and the open-vsx.org wiki.
  • Security and stability: The public registry does not have an official service-level agreement (SLA) and poses potential security risks from unvetted extensions.

    For a secure, stable, and high-performance environment, use a self-hosted registry with a curated set of extensions that meet your organization's requirements.
    Copy to Clipboard Toggle word wrap

Legal Notice

Copyright © Red Hat.
Except as otherwise noted below, the text of and illustrations in this documentation are licensed by Red Hat under the Creative Commons Attribution–Share Alike 3.0 Unported license . 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, the Red Hat logo, JBoss, Hibernate, and RHCE are trademarks or registered trademarks of Red Hat, LLC. or its subsidiaries in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS is a trademark or registered trademark of Hewlett Packard Enterprise Development LP or its subsidiaries in the United States and other countries.
The OpenStack® Word Mark and OpenStack logo are trademarks or registered trademarks of the Linux Foundation, used under license.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

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

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

Theme

© 2026 Red Hat
Back to top