Skip to main content
Version: 8.8 (unreleased)

Helm chart parameters

Helm chart parameters let you configure the components and behavior of your Camunda Self-Managed installation. The main way to customize these parameters is by using a values.yaml file.

In Helm charts, the values.yaml file defines configuration for your deployment. To tailor your installation to your needs, you can override parameters in this file or provide your own values file. It’s best practice to keep the original values.yaml unchanged and maintain a separate file with your custom settings.

The following tables show the top-level configuration sections in values.yaml. Each section controls a specific area of the chart.

Global and orchestration cluster configuration

SectionPurpose
globalConfigures shared settings that apply across components
orchestrationConfigures orchestration cluster settings

Other Camunda applications

SectionPurpose
consoleConfigures the Camunda Self-Managed Console service
connectorsConfigures the Connector runtime
identityConfigures the Management Identity service
optimizeConfigures the Optimize web application
webModelerConfigures the Web Modeler service

Bitnami subcharts

SectionPurpose
elasticsearchProvides an embedded Elasticsearch backend (Bitnami subchart)
identityKeycloakProvides an embedded Keycloak service for Management Identity (Bitnami subchart)
identityPostgresqlProvides an embedded PostgreSQL database for Management Identity (Bitnami subchart)
webModelerPostgresqlProvides an embedded PostgreSQL database for Web Modeler (Bitnami subchart)

Bitnami subcharts guidance

Development and testing environments: Bitnami subcharts provide ready-to-use infrastructure components that you can deploy with Camunda applications using minimal configuration.

Production environments: Camunda recommends deploying infrastructure services separately from the Camunda Helm charts. This approach lets you:

  • Use your preferred deployment method and operational tooling
  • Leverage managed services such as AWS RDS, Azure Database, or Google Cloud SQL
  • Manage infrastructure lifecycle independently of Camunda applications
  • Implement your organization's security, backup, and monitoring standards

If you use Bitnami subcharts in production, consider Bitnami Premium images for enhanced security patches and vendor support. Operational expertise with Bitnami chart production deployments is recommended.

Observability

SectionPurpose
prometheusServiceMonitorCreates a Prometheus ServiceMonitor resource for metrics

Where to find all chart parameters

For a full list of supported Helm chart parameters, including default values and descriptions, see Helm chart parameters on Artifact Hub.

Check this page when installing or upgrading to ensure you use the latest options for your chart version.

Provided values files

In addition to the default values.yaml, the Helm chart repository includes several additional values files for special use cases.
You can use these files individually or combine them with your own overrides.

FilePurpose
values.yamlThe default configuration. Includes all chart parameters with baseline values.
values-local.yamlOptimized for local development (for example, kind or Minikube). Adjusts resource requests and limits for smaller environments.
values-enterprise.yamlSwitches Bitnami subcharts to Camunda Enterprise images. For Camunda Enterprise customers only.
values-bitnami-legacy.yamlUses the archived Bitnami open-source images for subcharts instead of the default ones. Deprecated; see bitnami/containers#83267. Provided only as a temporary transition option.
values-latest.yamlTracks the latest versions of applications and subcharts. This may include breaking changes and is intended for early testing.
values-digest.yamlUses the latest snapshot images referenced by digest (for internal development only).

Creating your own values files

To customize parameters, create an override file (for example, my-overrides.yaml) with custom settings.
This approach is recommended over editing values.yaml directly.

Combining multiple values files

Helm lets you specify multiple values files. You can layer them to build the configuration you need:

helm install camunda camunda/camunda-platform \
-f values.yaml \
-f values-enterprise.yaml \
-f my-overrides.yaml

If the same parameter is defined in more than one file, the value in the last file listed takes precedence. In the example above, settings from my-overrides.yaml override values from both values-enterprise.yaml and values.yaml.