Cluster Chart : DevWorkspaces

This helm chart is used to deploy Dev Workspaces operator to help you develop your applications into kubernetes cluster.

This chart is part of the cluster-xxx startx helm chart series that doesn’t necessarily deploy pods but rather represent a cluster configuration state orchestrated by gitops tools like ArgoCD.

Requirements and guidelines

Read the startx helm-repository homepage for more information on how to use theses resources.

Deploy this helm chart on openshift

1. Connect to your Openshift cluster

oc login -t <token> <cluster-url>

2. Install the repository

helm repo add startx https://helm-repository.readthedocs.io/en/latest/repos/stable/

3. Get information about this chart

helm show chart startx/cluster-devworkspaces

4. Install this chart

helm install cluster-devworkspaces startx/cluster-devworkspaces

Default values

Complete deployment of a project with the following characteristics :

1 operator: named devworkspace-operator configured with
The fast channel for community release
The v0.39.0 version
Deployed under the openshift-operators project

# Create the project
helm install cluster-devworkspaces-project startx/cluster-devworkspaces --set project.enabled=true,operator.enabled=false,devworkspaces.enabled=false
# Deploy the devworkspace operator
helm install cluster-devworkspaces-operator startx/cluster-devworkspaces --set project.enabled=false,operator.enabled=true,devworkspaces.enabled=false && sleep 10
# Configure default devworkspace resources
helm install cluster-devworkspaces-instance startx/cluster-devworkspaces --set project.enabled=false,operator.enabled=false,devworkspaces.enabled=true

Others values availables

startx : DevWorkspaces operator (see values.yaml)

helm install cluster-devworkspaces startx/cluster-devworkspaces -f https://raw.githubusercontent.com/startxfr/helm-repository/master/charts/cluster-devworkspaces/values-startx.yaml

Deploy with ArgoCD

AppProject

apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: cluster-devworkspaces
  namespace: openshift-gitops
spec:
  description: Deploy DevWorkspace operator and configure development workspaces
  sourceRepos:
    - http://sx-helm-repository-prod.s3-website.eu-west-3.amazonaws.com/stable
  destinations:
    - namespace: startx-devworkspaces
      server: https://kubernetes.default.svc
    - namespace: openshift-operators
      server: https://kubernetes.default.svc
    - namespace: openshift-gitops
      server: https://kubernetes.default.svc
  clusterResourceWhitelist:
    - group: '*'
      kind: '*'
  namespaceResourceWhitelist:
    - group: '*'
      kind: '*'

Applications

---
# Creates namespace startx-devworkspaces
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: cluster-devworkspaces-project
  namespace: openshift-gitops
  annotations:
    argocd.argoproj.io/sync-wave: "1"
spec:
  project: cluster-devworkspaces
  source:
    repoURL: http://sx-helm-repository-prod.s3-website.eu-west-3.amazonaws.com/stable
    chart: cluster-devworkspaces
    targetRevision: 21.3.55
    helm:
      valueFiles:
        - values-startx_noinfra.yaml
      values: |
        project:
          enabled: true
  destination:
    server: https://kubernetes.default.svc
    namespace: openshift-gitops
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
---
# Deploys DevWorkspace operator in openshift-operators (shared namespace, global-operators OG already exists)
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: cluster-devworkspaces-operator
  namespace: openshift-gitops
  annotations:
    argocd.argoproj.io/sync-wave: "5"
  finalizers:
    - resources-finalizer.argocd.argoproj.io
spec:
  project: cluster-devworkspaces
  source:
    repoURL: http://sx-helm-repository-prod.s3-website.eu-west-3.amazonaws.com/stable
    chart: cluster-devworkspaces
    targetRevision: 21.3.55
    helm:
      valueFiles:
        - values-startx_noinfra.yaml
      values: |
        operator:
          enabled: true
          subscription:
            enabled: true
          operatorGroup:
            enabled: false
  destination:
    server: https://kubernetes.default.svc
    namespace: openshift-operators
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
---
# Configures DevWorkspace instances in startx-devworkspaces
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: cluster-devworkspaces-app
  namespace: openshift-gitops
  annotations:
    argocd.argoproj.io/sync-wave: "10"
  finalizers:
    - resources-finalizer.argocd.argoproj.io
spec:
  project: cluster-devworkspaces
  source:
    repoURL: http://sx-helm-repository-prod.s3-website.eu-west-3.amazonaws.com/stable
    chart: cluster-devworkspaces
    targetRevision: 21.3.55
    helm:
      valueFiles:
        - values-startx_noinfra.yaml
      values: |
        devworkspaces:
          enabled: false
  destination:
    server: https://kubernetes.default.svc
    namespace: startx-devworkspaces
  ignoreDifferences:
    - group: workspace.devfile.io
      kind: DevWorkspace
      jsonPointers:
        - /metadata/finalizers
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

History

Release	Date	Description
16.19.59	2024-12-09	Align all chart to the 16.19.59 release
17.14.19	2025-03-12	Align all chart to the 17.14.19 release
17.14.90	2025-04-30	Publish stable release for 4.17 version
18.11.71	2025-11-27	Align all charts to the same releas
18.23.0	2026-02-28	Start 4.19 branch
19.23.15	2026-03-02	Prepare upgrading dependency to 19.23.11
19.23.17	2026-03-02	Align all dependencies to chart v19.23.11
20.14.7	2026-03-02	Update dependencies to version 20.14.0
20.14.15	2026-03-02	Update all chrat to OCP version 4.20.14
21.3.0	2026-03-02	Update all chart to OCP version 4.21.3
21.3.1	2026-03-02	Prepare release 21.3.x with 21.x dependencies
21.3.3	2026-03-02	Upgrade dependencies to v21.3.0
21.3.4	2026-06-17	21.3.9
21.3.11	2026-06-17	publish stable update for the full repository
21.3.12	2026-06-18	Update devworkspace-operator to 0.41.0, add ArgoCD deployment examples
21.3.27	2026-06-19	publish stable update for the full repository
21.3.55	2026-06-19	publish stable update for the full repository