Share preconfigured workspace links with your team
Share preconfigured workspace links with your team by appending optional parameters to the URL that starts a new workspace so you can control the IDE, storage, resource limits, and devfile configuration without editing files.
When you open a Git repository URL in OpenShift Dev Spaces, you can add query parameters to control the IDE, workspace storage, resource limits, devfile path, and other workspace settings.
- URL parameter concatenation
Combine multiple URL parameters when starting an OpenShift Dev Spaces workspace by concatenating them with&. This enables you to customize the editor, storage type, devfile, and other workspace settings in a single URL. - URL parameter for the IDE
Theche-editor=URL parameter specifies a supported IDE when starting a workspace, allowing you to override the default editor or theche-editor.yamlfile without modifying the Git repository. - URL parameter for the IDE image
Theeditor-imageURL parameter sets a custom IDE image for the workspace, allowing you to test prerelease IDE builds or use a customized IDE container. - URL parameter for starting duplicate workspaces
Use thenewURL parameter to create multiple workspaces from the same devfile and Git repository, which is useful when you need parallel environments for testing or comparing changes. - URL parameter for the existing workspace name
Use theexistingURL parameter to reopen an existing workspace instead of creating a new one, which avoids duplicate workspaces when revisiting a workspace URL. - URL parameter for the devfile file name
Use thedfURL parameter to specify a custom devfile file name when the repository uses a name other than the default.devfile.yamlordevfile.yaml. - URL parameter for the devfile file path
Use thedevfilePathURL parameter to specify a custom path to the devfile when it is not in the root directory of the linked Git repository. - URL parameter for the workspace storage
Use thestorageTypeURL parameter to override the default storage strategy for a new workspace, choosing between persistent and ephemeral storage based on your data retention needs. - URL parameter for additional remotes
Configure additional Git remotes when starting a workspace by specifying extra repository URLs as parameters, enabling work with multiple upstream sources in a single workspace. - URL parameter for a container image
TheimageURL parameter specifies a custom container image for the workspace, allowing you to use a different base image than the one defined in the devfile or the default Universal Developer Image. - URL parameter for a memory limit
ThememoryLimitURL parameter specifies or overrides the container memory limit when starting a new workspace from a devfile URL. Use this parameter to allocate enough memory for resource-intensive development tasks. - URL parameter for a CPU limit
ThecpuLimitURL parameter specifies or overrides the container CPU limit when starting a new workspace from a devfile URL. Use this parameter to allocate enough CPU for resource-intensive development tasks. - URL parameter for the AI provider
Use theai-provider=URL parameter to specify one or more AI providers in a workspace start URL. The workspace launches with the selected AI tool binaries injected and ready to use, without requiring manual selection on the dashboard. - Start a cloud development environment from a raw devfile URL
Start a cloud development environment from a devfile hosted outside your Git repository so that you can share a standard development environment across teams or test devfile changes before committing them. - Prevent workspace idling for long-running commands
Prevent a workspace from stopping while long-running CLI tools such ashelm,odo, orsleepare active, so that unattended tasks can complete without interruption.