Midaz via Helm

Deploy and operate Midaz on Kubernetes with the official Helm chart.

Use the official Helm chart to deploy Midaz on Kubernetes. The chart manages the Ledger workload and can deploy its Valkey, PostgreSQL, MongoDB, and RabbitMQ dependencies.

Guides

• Installing Midaz with Helm
• Configuring ingress
• Configuring observability
• Configuring dependencies
• Midaz components reference
• Configuration reference
• Upgrade guide
• Migration guides
• Version compatibility

Prerequisites

Before installing, prepare:

• A Kubernetes cluster compatible with your selected chart and ingress controller.
• Helm 3 installed locally.
• Access to the container registry that serves the selected images.
• DNS and TLS material when you expose services through ingress.

Quick start

Create a values.yaml that supplies the chart’s required credentials before installing. When you use bundled RabbitMQ, follow the dependency configuration.

CHART_VERSION=replace-with-chart-version
helm show chart oci://registry-1.docker.io/lerianstudio/midaz-helm --version "$CHART_VERSION"
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --version "$CHART_VERSION" -n midaz --create-namespace -f values.yaml

The OpenTelemetry Collector is deployed separately. The Midaz chart’s default telemetry setting injects collector connection variables into Ledger, CRM, and Tracer. It does not install the collector.

Resources

• Helm chart repository
• Midaz architecture overview