Fully Support Helm v4

[jlehman9]

What happened?

DevSpace does not appear to entirely support the new Helm v4 standard.

I tested our project's main SDK chart (which includes many dependency charts) and was able to deploy directly with helm install ...:

❯ helm install sdk . -n sdk -f ./values.yaml -f ./values/dev-values.yaml
NAME: sdk
LAST DEPLOYED: Mon Jan  5 16:08:43 2026
NAMESPACE: sdk
STATUS: deployed
REVISION: 1
DESCRIPTION: Install complete

But when using DevSpace, I get this error:

+ create_deployments sdk --set helm.valuesFiles[0]=values.yaml --set helm.valuesFiles[1]=values/dev-values.yaml
deploy:sdk Deploying chart ./ (sdk) with helm...
create_deployments: error deploying sdk: unable to deploy helm chart: Release "sdk" does not exist. Installing it now.
 error executing '/Users/[USER]/.devspace/bin/helm upgrade sdk --values /var/folders/__/_sn10cxx6kqc11fcds30658m0000gr/T/1572961959 --install --namespace sdk ./ --kube-context orbstack': Error: template: sdk/templates/realm-config.yaml:149:20: executing "sdk/templates/realm-config.yaml" at <include "sdk.icam.client" (dict "Values" $.Values "client" $client)>: error calling include: template: sdk/templates/_helpers.tpl:276:3: executing "sdk.icam.client" at <tpl (include "sdk.icam.clientTemplate" . | fromYaml | merge $client | toYaml) .>: error calling tpl: cannot retrieve Template.Basepath from values inside tpl function: attributes:
   [ATTRIBUTE VALUES]
clientAuthenticatorType: [CLIENT TYPE]
clientId: [CLIENT ID]
defaultClientScopes:
- [CLIENT SCOPES]
defaultRoles:
- [ROLES]
enabled: true
name: [NAME]
optionalClientScopes:
- [OP SCOPES]
redirectUris:
- https://{{ .Values.global.appsSubdomain }}.{{ .Values.global.domain }}{{ .Values.global.contextPath
  }}/*
- http://{{ .Values.global.appsSubdomain }}.{{ .Values.global.domain }}{{ .Values.global.contextPath
  }}/*
secret: [SECRET]
standardFlowEnabled: true: "BasePath" is not a value

fatal exit status 1

From what I can tell, this is from a named helper template in our _helpers.tpl file regarding a scope issue in this function:

{{- define "sdk.icam.client" -}}
{{- $client := .client }}
{{- if not $client.secret }}
{{- $_ := set $client "secret" (include "sdk-common.keycloak.secret" .) }}
{{- end }}
{{ tpl (include "sdk.icam.clientTemplate" . | fromYaml | merge $client | toYaml) . }}
{{- end -}}

But my limited attempts to fix it never gave me a different error, leading me to believe it's an issue with the way DevSpace handles templating since it works when installed with Helm directly.

What did you expect to happen instead?

Running devspace deploy would deploy our chart(s) as normal from Helm v3

How can we reproduce the bug? (as minimally and precisely as possible)

I can't provide our devspace.yaml files because they're for CUI projects. Hopefully the template function and error are enough information to get started, but I can try to provide more information if needed. I'm also available in the vCluster Slack "@alex Lehman" for quicker back and forth.

Local Environment:

• DevSpace Version: 6.3.18
• Operating System: mac
• ARCH of the OS: ARM64
  Kubernetes Cluster:
• Cloud Provider: local
• Kubernetes Version: v1.33.5 (client v1.35.0)

Anything else we need to know?