Helm chart configuration parameters
Use the overview of default Helm Chart values to configure and customize your RHDH deployment.
The values are organized into five main categories, which cover the key namespaces that organize the chart’s hierarchical configuration structure:
- Global
- Orchestrator
- Route
- Test
- Upstream
Display a complete list of Helm Chart values with Helm CLI Copy linkLink copied!
Use the available options to configure Red Hat Developer Hub with Helm Charts: the Helm deployment method specific configuration files.
Procedure Copy linkLink copied!
Global and chart configuration values Copy linkLink copied!
You can customize settings that affect all chart resources, including image registries, storage classes, and resource naming.
Not all of these values are under the global key. The global.* values apply across every chart dependency, such as the built-in PostgreSQL chart dependency. The remaining values also apply chart-wide, but you set them at the top level of the chart’s values file.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Global container image registry. Overrides per-image registries for all containers. |
string |
|
|
|
Global container image registry secret names. |
list |
|
|
|
Global default StorageClass for PVCs. |
string |
|
|
|
Override the chart name used in resource naming. |
string |
|
|
|
Override the full resource name. |
string |
|
|
|
Labels applied to all chart resources. |
object |
|
|
|
Annotations applied to all chart resources. |
object |
|
|
|
Array of extra objects to deploy with the release, rendered through Helm’s |
list |
|
|
|
Custom hostname for the RHDH instance. |
string |
|
Container image values Copy linkLink copied!
You can configure the container image used for the main RHDH deployment, including the registry, repository, tag, and pull policy.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Container image configuration for the main RHDH container. |
object |
See child keys |
|
|
Image registry. |
string |
|
|
|
Image repository. |
string |
|
|
|
Image tag. |
string |
|
|
|
Image pull policy. |
string |
|
|
|
Overrides the image tag with an image digest. |
string |
|
|
|
Secrets for pulling images from private registries. Merged with |
list |
|
Application configuration values Copy linkLink copied!
You can configure the Backstage application settings and backend service-to-service authentication for your RHDH instance.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Inline Backstage app-config YAML. Rendered into a ConfigMap and mounted as |
object |
See child keys |
|
|
Authentication providers configuration. |
object |
See child keys |
|
|
Authentication provider settings. |
object |
|
|
|
Base URL for the Backstage front-end application. |
string |
Go template |
|
|
Base URL for the Backstage backend. |
string |
Go template |
|
|
Allowed CORS origin for the backend. |
string |
Go template |
|
|
Database connection host. Resolved from environment variables. |
string |
|
|
|
Database connection port. |
string |
|
|
|
Database connection user. |
string |
|
|
|
Database connection password. |
string |
|
|
|
External access configuration for backend authentication. |
list |
See child keys |
|
|
Additional app-config files from existing ConfigMaps. Each item requires |
list |
|
|
|
Backend service-to-service authentication configuration. |
object |
See child keys |
|
|
Enable backend service-to-service authentication. Generates a random secret unless |
boolean |
|
|
|
Name of an existing Secret containing the backend auth token. When empty, the chart generates one. |
string |
|
|
|
Key within the Secret that holds the backend auth token. |
string |
|
|
|
Use a specific value for the backend auth token instead of generating one. |
string |
|
Environment and command override values Copy linkLink copied!
You can override the default container command, arguments, and environment variables for the main RHDH container. The chart provides both override keys that fully replace system defaults and extra keys that append to them.
The override keys (for example, commandOverride and envOverride) replace system defaults entirely. When you use an override key, system-injected environment variables such as BACKEND_SECRET and database credentials are not added automatically. Use the extra keys (for example, extraEnv and extraArgs) to add values without replacing the defaults.
If you use an override key, you are responsible for keeping its contents in sync with any future changes to the system defaults. A later RHDH upgrade can change the default command, arguments, or environment variables, and those changes are not reflected automatically in your override. Review your override values after each upgrade.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Override the container command. |
list |
|
|
|
Override the container arguments entirely. When set, system config arguments are not added automatically; you must include them yourself. |
list |
|
|
|
Override the container environment variables entirely. When set, system env vars ( |
list |
|
|
|
Override the container |
list |
|
The extraArgs, extraEnv, and extraEnvFrom keys append to the system defaults instead of overriding them, so they are not listed in this table.
Dynamic plugins values Copy linkLink copied!
You can configure the dynamic plugins system, including plugin includes, the plugin list, volume settings for the plugins root directory, and the init container that installs plugins at startup. You can also configure the catalog index for plugin discovery in the Extensions UI.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Dynamic plugins system configuration. |
object |
See child keys |
|
|
Array of YAML files listing dynamic plugins to include. Relative paths are resolved from the working directory of the init container ( |
list |
|
|
|
List of dynamic plugins. Every item defines the plugin |
list |
|
|
|
Maximum uncompressed size (in bytes) of a single dynamic plugin entry. |
integer |
|
|
|
Volume configuration for the dynamic plugins root directory. |
object |
See child keys |
|
|
Volume type: |
string |
|
|
|
StorageClass for the ephemeral volume. When empty, uses |
string |
|
|
|
Access modes for the ephemeral PVC. |
list |
|
|
|
Storage request for the ephemeral PVC. |
string |
|
|
|
Raw Kubernetes emptyDir volume spec. Used when type is |
object |
|
|
|
Name of the PersistentVolumeClaim to use. Used when type is |
string |
|
|
|
StorageClass for the |
string |
|
|
|
Access modes for the |
list |
|
|
|
Storage request for the |
string |
|
|
|
Configuration for the |
object |
See child keys |
|
|
Override the default command. |
list |
|
|
|
Override the default arguments. |
list |
|
|
|
Extra arguments appended after the default arguments. Ignored when |
list |
|
|
|
Extra environment variables appended after the system env vars. |
list |
|
|
|
Additional volume mounts appended after the system mounts. |
list |
|
|
|
Resource requests and limits. Defaults: requests cpu=250m, memory=256Mi; limits cpu=1000m, memory=2.5Gi, ephemeral-storage=5Gi. |
object |
See description |
|
|
Security context for the init container. Defaults to the value of |
object |
|
|
|
Plugin catalog index image configuration for plugin discovery in the Extensions UI. |
object |
See child keys |
|
|
Catalog index image registry. |
string |
|
|
|
Catalog index image repository. |
string |
|
|
|
Catalog index image tag. |
string |
|
|
|
Overrides the image tag with an image digest. |
string |
|
|
|
Extra catalog index images for additional plugin discovery. Each item must include |
list |
|
Deployment and pod values Copy linkLink copied!
You can configure deployment settings, pod scheduling, security contexts, resource limits, health probes, extra volumes, and autoscaling for your RHDH instance.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Number of desired pods. |
integer |
|
|
|
Number of old ReplicaSets to retain. |
integer |
|
|
|
Deployment update strategy. |
object |
|
|
|
Kubernetes workload controller for the RHDH pod. |
object |
See child keys |
|
|
Workload kind: |
string |
|
|
|
Service name for the |
string |
|
|
|
Pod management policy for the |
string |
|
|
|
|
object |
|
|
|
Optional PVC retention policy for the |
object |
|
|
|
Extra volume claim templates appended after the chart-managed |
list |
|
|
|
Annotations for the |
object |
|
|
|
ServiceAccount configuration. |
object |
See child keys |
|
|
Create a ServiceAccount. |
boolean |
|
|
|
Automount the ServiceAccount token. |
boolean |
|
|
|
Additional labels for the ServiceAccount. |
object |
|
|
|
Annotations for the ServiceAccount. |
object |
|
|
|
The name of the service account to use. If not set and |
string |
|
|
|
Annotations to add to the pod. |
object |
|
|
|
Labels to add to the pod. |
object |
|
|
|
Pod-level security context. |
object |
|
|
|
Security context for the main RHDH container (not the Lightspeed sidecar or init containers). |
object |
See child keys |
|
|
Mount the container root filesystem as read-only. |
boolean |
|
|
|
Prevent privilege escalation. |
boolean |
|
|
|
Linux capabilities to drop. |
list |
|
|
|
Run the container as a non-root user. |
boolean |
|
|
|
Seccomp profile type. |
string |
|
|
|
Resource requests and limits for the main RHDH container. |
object |
See child keys |
|
|
CPU request. |
string |
|
|
|
Memory request. |
string |
|
|
|
CPU limit. |
string |
|
|
|
Memory limit. |
string |
|
|
|
Ephemeral storage limit. |
string |
|
|
|
Startup probe configuration. Uses HTTP GET on |
object |
See description |
|
|
Readiness probe configuration. Uses HTTP GET on |
object |
See description |
|
|
Liveness probe configuration. Uses HTTP GET on |
object |
See description |
|
|
Additional volumes to add to the pod. These are appended to the system volumes. |
list |
|
|
|
Additional volume mounts to add to the main container. These are appended to the system mounts. |
list |
|
|
|
Additional sidecar containers. |
list |
|
|
|
Init containers to run before the system init containers. |
list |
|
|
|
Additional init containers. These are added after system init containers. |
list |
|
|
|
Node labels for pod assignment. |
object |
|
|
|
Tolerations for pod assignment. |
list |
|
|
|
Affinity rules for pod assignment. |
object |
|
|
|
Topology spread constraints for pod scheduling. |
list |
|
|
|
Host aliases for |
list |
|
|
|
Priority class name for pod scheduling. |
string |
|
|
|
Duration in seconds the pod needs to stop gracefully before being forcibly stopped. |
integer |
|
|
|
Lifecycle hooks for the main RHDH container. |
object |
|
|
|
Annotations for the Deployment resource (not the pod). |
object |
|
|
|
Horizontal Pod Autoscaler configuration. |
object |
See child keys |
|
|
Enable autoscaling. |
boolean |
|
|
|
Minimum number of replicas. |
integer |
|
|
|
Maximum number of replicas. |
integer |
|
|
|
Target CPU utilization percentage. |
integer |
|
|
|
Pod disruption budget configuration. |
object |
See child keys |
|
|
Create a PodDisruptionBudget. |
boolean |
|
|
|
Minimum number of pods that must be available. |
string |
|
|
|
Maximum number of pods that can be unavailable. |
integer |
|
Networking namespace values Copy linkLink copied!
You can configure the Kubernetes Service, Ingress, and Gateway API HTTPRoute for your RHDH instance.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Kubernetes Service configuration. |
object |
See child keys |
|
|
Service type. |
string |
|
|
|
Service port. |
integer |
|
|
|
Additional service ports. Default includes |
list |
See description |
|
|
Service annotations. |
object |
|
|
|
NodePort value. Only used when |
string |
|
|
|
Session affinity. |
string |
|
|
|
Static ClusterIP. Set to |
string |
|
|
|
LoadBalancer IP address. |
string |
|
|
|
Allowed source ranges for LoadBalancer. |
list |
|
|
|
External traffic policy. |
string |
|
|
|
IP family policy for dual-stack support. |
string |
|
|
|
IP families for dual-stack support. |
list |
|
|
|
Kubernetes Ingress configuration. |
object |
See child keys |
|
|
Enable Ingress. |
boolean |
|
|
|
Ingress class name. |
string |
|
|
|
Ingress annotations. |
object |
|
|
|
Ingress host rules. Default: one host entry using |
list |
See description |
|
|
TLS configuration for Ingress. |
list |
|
|
|
Gateway API HTTPRoute configuration. |
object |
See child keys |
|
|
Enable HTTPRoute. |
boolean |
|
|
|
Labels for the HTTPRoute. |
object |
|
|
|
Annotations for the HTTPRoute. |
object |
|
|
|
Parent references for the HTTPRoute. |
list |
|
|
|
Hostnames for the HTTPRoute. |
list |
|
|
|
Routing rules for the HTTPRoute. |
list |
|
OpenShift namespace values Copy linkLink copied!
You can configure OpenShift Container Platform-specific settings, including the cluster router base URL and the Route resource for your RHDH instance.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
OpenShift Container Platform-specific configuration. |
object |
See child keys |
|
|
Base domain for the OpenShift Container Platform cluster router. Used to construct the default hostname for your RHDH instance. |
string |
|
|
|
OpenShift Container Platform Route configuration. |
object |
See child keys |
|
|
Annotations for the Route. |
object |
|
|
|
Enable the OpenShift Container Platform Route. |
boolean |
|
|
|
Hostname for the Route. Defaults to the value of the |
string |
"{{ .Values.host }}" |
|
|
Path for the Route. |
string |
|
|
|
Wildcard policy for the Route. |
string |
|
|
|
Name of the Service port that the Route targets. |
string |
|
|
|
TLS configuration for the Route. |
object |
See child keys |
|
|
Enable TLS on the Route. |
boolean |
|
|
|
TLS termination type. |
string |
|
|
|
TLS certificate. |
string |
|
|
|
TLS private key. |
string |
|
|
|
CA certificate. |
string |
|
|
|
Destination CA certificate for re-encrypt termination. |
string |
|
|
|
Insecure edge termination policy. |
string |
|
Database namespace values Copy linkLink copied!
You can configure the built-in PostgreSQL database or connect to an external PostgreSQL instance for your RHDH deployment.
To use an external PostgreSQL database, set postgresql.enabled to false and configure the externalDatabase values.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Built-in PostgreSQL database configuration (Bitnami subchart). Enabled by default. |
object |
See child keys |
|
|
Enable the built-in PostgreSQL database. |
boolean |
|
|
|
PostgreSQL data directory. |
string |
|
|
|
Enable service bindings for the PostgreSQL instance. |
boolean |
|
|
|
PostgreSQL image registry. |
string |
|
|
|
PostgreSQL image repository. |
string |
|
|
|
PostgreSQL image tag. |
string |
|
|
|
Overrides the image tag with an image digest. |
string |
|
|
|
Key in the Secret for the PostgreSQL admin password. |
string |
|
|
|
Key in the Secret for the PostgreSQL user password. |
string |
|
|
|
Enable pod security context for the PostgreSQL primary. |
boolean |
|
|
|
Enable container security context for the PostgreSQL primary. |
boolean |
|
|
|
Resource requests and limits. Defaults: requests |
object |
See description |
|
|
Enable persistence for the PostgreSQL primary. |
boolean |
|
|
|
Size of the persistent volume. |
string |
|
|
|
Mount path for the persistent volume. |
string |
|
|
|
External database connection configuration. Used when |
object |
See child keys |
|
|
External database hostname. |
string |
|
|
|
External database port. |
integer |
|
|
|
External database user. |
string |
|
|
|
Name of an existing Secret containing the database password. |
string |
|
|
|
Key within the Secret that holds the database password. |
string |
|
Metrics namespace values Copy linkLink copied!
You can configure Prometheus metrics collection and the ServiceMonitor resource for your RHDH instance.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Metrics and monitoring configuration. |
object |
See child keys |
|
|
Prometheus ServiceMonitor configuration. |
object |
See child keys |
|
|
Enable the ServiceMonitor resource. |
boolean |
|
|
|
Metrics endpoint path. |
string |
|
|
|
Name of the Service port to scrape. |
string |
|
|
|
Scrape interval. When empty, uses the Prometheus default. |
string |
|
|
|
Labels for the ServiceMonitor. Use these to match the Prometheus operator’s |
object |
|
|
|
Annotations for the ServiceMonitor. |
object |
|
Developer Hub Intelligent Assistant values Copy linkLink copied!
You can configure the Red Hat Developer Hub Intelligent Assistant, the AI assistant, as a first-class feature of your RHDH instance, including the dynamic plugins, configuration files, Offline Knowledge Portal (OKP), and core sidecar.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Intelligent Assistant AI configuration. |
object |
See child keys |
|
|
Enable Intelligent Assistant. |
boolean |
|
|
|
Dynamic plugin definitions for Intelligent Assistant. Default includes the front-end and back-end plugins. |
list |
See description |
|
|
Configuration files for Intelligent Assistant. |
object |
See child keys |
|
|
Name of an existing ConfigMap containing the Lightspeed stack configuration (lightspeed-stack.yaml). |
string |
|
|
|
Key within the ConfigMap that holds the file content. Defaults to the bundled filename (lightspeed-stack.yaml) if not set. |
string |
|
|
|
Name of an existing ConfigMap containing the Python profile with prompt templates (rhdh-profile.py). |
string |
|
|
|
Key within the ConfigMap that holds the file content. Defaults to the bundled filename (rhdh-profile.py) if not set. |
string |
|
|
|
Name of an existing Secret that supplies credentials and settings to the lightspeed-core container. Configure the provider itself in lightspeed-stack.yaml. If empty, no Secret is loaded. Expected keys (all optional; include only keys used by the configured provider): Set |
string |
|
|
|
Writable scratch volume for the sidecar (/tmp). |
object |
See child keys |
|
|
Volume type: |
string |
|
|
|
Raw Kubernetes emptyDir volume spec. Used when type is |
object |
|
|
|
Raw Kubernetes PVC volume spec. Used when type is |
object |
|
|
|
Lightspeed Core sidecar container configuration. |
object |
See child keys |
|
|
Core sidecar image registry. |
string |
|
|
|
Core sidecar image repository. |
string |
|
|
|
Core sidecar image tag. |
string |
|
|
|
Overrides the image tag with an image digest. |
string |
|
|
|
Image pull policy for the core sidecar. |
string |
|
|
|
Override the container’s default command. Leave empty to use the image entrypoint. |
list |
|
|
|
Override the container’s default args. Leave empty to use the chart defaults. |
list |
|
|
|
Extra arguments appended after the default arguments. Ignored when argsOverride is set. |
list |
|
|
|
Extra environment variables. |
list |
|
|
|
Additional volume mounts. |
list |
|
|
|
Resource requests and limits. Defaults: requests |
object |
See description |
|
|
Security context. Default: |
object |
See description |
|
|
OKP (Offline Knowledge Portal) configuration. Deploys an OKP instance for document retrieval when Intelligent Assistant is enabled. |
object |
See child keys |
|
|
Enable OKP-backed documentation retrieval. Disabled by default on all platforms. |
boolean |
|
|
|
OKP container image registry. |
string |
|
|
|
OKP container image repository. |
string |
|
|
|
OKP container image tag. |
string |
|
|
|
Overrides the image tag with an image digest. |
string |
|
|
|
Image pull policy for the OKP container. |
string |
|
|
|
Number of OKP pods. |
integer |
|
|
|
Image pull secrets for the OKP container image. Required on uncustomized Kubernetes to authenticate with |
list |
|
|
|
Memory allocation for Solr. |
string |
|
|
|
Host bind address for Solr. |
string |
|
|
|
Apache httpd server name. |
string |
|
|
|
Enable compression for httpd. |
string |
|
|
|
Enable encryption for httpd. |
string |
|
|
|
Resource requests and limits. Defaults: requests |
object |
See description |
|
|
Kubernetes Service type for OKP. |
string |
|
|
|
Pod scheduling: affinity rules for the OKP pod. |
object |
|
|
|
Pod scheduling: node selector for the OKP pod. |
object |
|
|
|
Pod scheduling: tolerations for the OKP pod. |
list |
|
|
|
Pod scheduling: topology spread constraints for the OKP pod. |
list |
|
|
|
Readiness probe configuration for the OKP container. |
object |
See description |
|
|
Initial delay before readiness probe starts. |
integer |
|
|
|
How often to perform the readiness probe. |
integer |
|
|
|
Liveness probe configuration for the OKP container. |
object |
See description |
|
|
Initial delay before liveness probe starts. |
integer |
|
|
|
How often to perform the liveness probe. |
integer |
|
|
|
OpenShift Route configuration for OKP. |
object |
See child keys |
|
|
Enable OpenShift Route for OKP. |
boolean |
|
|
|
TLS termination type. |
string |
|
|
|
Policy for insecure traffic. |
string |
|
|
|
Kubernetes Ingress configuration for OKP. |
object |
See child keys |
|
|
Enable Kubernetes Ingress for OKP. |
boolean |
|
|
|
Ingress class name. |
string |
|
|
|
Ingress hostname. |
string |
|
|
|
Annotations for the Ingress resource. |
object |
|
|
|
Enable TLS for Ingress. |
boolean |
|
|
|
Name of the TLS Secret. |
string |
|
|
|
OKP container security context. |
object |
See description |
Orchestrator namespace values Copy linkLink copied!
You can configure the Orchestrator serverless workflow feature, including the SonataFlow platform, eventing, external database connections, and dynamic plugins for your RHDH instance.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Orchestrator serverless workflow configuration. |
object |
See child keys |
|
|
Enable the Orchestrator feature. |
boolean |
|
|
|
Enable the Serverless Logic Operator. |
boolean |
|
|
|
Enable the Serverless Operator. |
boolean |
|
|
|
SonataFlow platform configuration. |
object |
See child keys |
|
|
Enable monitoring for the SonataFlow platform. |
boolean |
|
|
|
Name of the eventing broker. |
string |
|
|
|
Namespace of the eventing broker. |
string |
|
|
|
Resource requests and limits. Defaults: requests memory=64Mi, cpu=250m; limits memory=1Gi, cpu=500m. |
object |
See description |
|
|
Name of an existing Secret for the external database credentials. |
string |
|
|
|
External database name. |
string |
|
|
|
External database host. |
string |
|
|
|
External database port. |
string |
|
|
|
Database creation job configuration. |
object |
See child keys |
|
|
Number of retries before the job is considered failed. |
integer |
|
|
|
Time-to-live after job completion. |
string |
(not set) |
|
|
Maximum time (seconds) for the job to run. |
integer |
|
|
|
Image for the database creation job. Defaults to the PostgreSQL image values. |
object |
See description |
|
|
Data Index service image. Registry, repository, tag, and digest all default to empty strings. |
object |
See description |
|
|
Job Service image. Registry, repository, tag, and digest all default to empty strings. |
object |
See description |
|
|
Dynamic plugin definitions for the Orchestrator. Default includes the back-end, form widgets, front-end, and scaffolder back-end module plugins from |
list |
See description |
Test namespace values Copy linkLink copied!
You can configure the Helm test pod used to verify that your RHDH instance is running correctly.
| Key | Description | Type | Default |
|---|---|---|---|
|
|
Helm test pod configuration. |
object |
See child keys |
|
|
Enable the Helm test pod. |
boolean |
|
|
|
Image for the test pod. |
object |
See child keys |
|
|
Test image registry. |
string |
|
|
|
Test image repository. |
string |
|
|
|
Test image tag. |
string |
|
|
|
Overrides the image tag with an image digest. |
string |
|
|
|
Image pull policy. |
string |
|
|
|
Security context for the test pod. Default: allowPrivilegeEscalation=false, readOnlyRootFilesystem=true, drop ALL capabilities. |
object |
See description |
Resource limits for installing Red Hat Developer Hub with the Orchestrator plugin when using Helm Copy linkLink copied!
When installing Red Hat Developer Hub (RHDH) with the Orchestrator plugin using Helm, the chart defines default CPU and memory limits for the SonataFlowPlatform component.
These limits are enforced by the cluster so that pods do not exceed their allocated resources.
- Default resource limits
| Resource | Default value |
|---|---|
|
CPU limits |
|
|
Memory limits |
|
- You can override these values in any of the following ways:
- With
values.yaml - With
--setflags
- With
- Override defaults with
values.yamlas shown in the following example:orchestrator: enabled: true sonataflowPlatform: resources: limits: cpu: "500m" memory: "1Gi" - Override with
--setas shown in the following example:$ helm upgrade --install <release_name> openshift-helm-charts/redhat-developer-hub \ --set orchestrator.enabled=true \ --set orchestrator.sonataflowPlatform.resources.requests.cpu=500m \ --set orchestrator.sonataflowPlatform.resources.requests.memory=128Mi \ --set orchestrator.sonataflowPlatform.resources.limits.cpu=1 \ --set orchestrator.sonataflowPlatform.resources.limits.memory=2GiNote The
--setsetting is applicable only whenorchestrator.enabledistrue. By default, it is set tofalse.