Helm chart version compatibility

Reference table mapping Helm chart versions to application versions for Midaz, plugins, and related Lerian products, so you can plan safe upgrades.

This page provides the official version mapping between Helm chart versions and application versions. Use it as a reference before deploying or upgrading your environment.

Looking for upgrade instructions? Check the Upgrading Helm guide for step-by-step procedures.

Source of truth

---

The official and most up-to-date version matrix is maintained in the Helm repository README. This matrix is automatically updated whenever applications have a new release, ensuring it always reflects the latest compatibility information.

The tables on this page are provided for quick reference, but always check the Helm repository for the most current versions.

Always update the Helm chart when updating applications. The Helm chart version and application versions are tightly coupled. Updating an application (like Midaz) without updating its corresponding Helm chart can cause deployment failures.

Exception: Some hotfixes may not require a Helm chart update. Check the release notes for specific guidance.

Versioning scheme

---

Lerian uses a prefixed semantic versioning scheme for Helm charts:

{component}-v{MAJOR}.{MINOR}.{PATCH}[-{prerelease}]

Examples:

• midaz-v4.4.8 - Midaz Helm chart version 4.4.8
• plugin-crm-v3.2.1 - CRM plugin chart version 3.2.1
• plugin-crm-v3.2.1-rc.1 - CRM plugin, release-candidate prerelease

The Chart version refers to the Helm chart package version. The App version refers to the actual application container image version deployed by the chart.

Midaz core

---

The main Midaz Helm chart deploys core services. Starting from chart v5.x, a unified Ledger service is available that combines Onboarding and Transaction functionality.

Chart version	Ledger	CRM	Onboarding	Transaction
8.7.0	3.8.0	3.8.0	-	-
8.4.0	3.7.7	3.7.6	-	-
5.7.0	3.5.3	3.5.3	3.5.3	3.5.3
5.3.0	3.5.1	3.5.1	3.5.1	3.5.1
4.4.8	-	-	3.4.4	3.4.7
4.3.4	-	-	3.4.3	3.4.6
4.0.0	-	-	3.0.0	3.0.0

Starting from chart v5.x, the Ledger service is the recommended deployment option, combining Onboarding and Transaction into a single service. The CRM backend is also included in the main Midaz chart (enabled via crm.enabled: true). See the Upgrading Helm guide for migration details.

For the complete version history, check the Helm repository tags.

Plugins

---

Plugins are deployed as separate Helm charts with independent versioning. Each plugin requires a valid Enterprise license.

CRM

The standalone plugin-crm chart includes a UI component and remains compatible with both chart v4.x and v5.x deployments.

Chart version	Backend	UI	Midaz Helm chart compatibility
5.0.0	3.5.1	2.0.0	v4.x, v5.x
4.0.0	3.5.1	2.0.0	v4.x, v5.x
3.2.1	2.0.0	2.0.0	v3.x, v4.x
3.1.0	2.0.0	2.0.0	v3.x, v4.x

Fees Engine

Chart version	Backend	UI	Midaz Helm chart compatibility
7.3.0	3.4.0	-	-
7.0.0	3.2.1	3.0.0	-
4.1.2	3.0.8	3.0.0	v3.x, v4.x, v5.x
3.5.1	3.0.5	3.0.0	v3.x, v4.x, v5.x
3.4.7	3.0.3	3.0.0	v3.x, v4.x

Fees Engine is only available for Midaz v3 and later. It is not compatible with Midaz v2.

Pix

Chart version	Pix	Job	Midaz Helm chart compatibility
3.0.0	1.2.1-beta.11	1.2.1-beta.12	-
1.2.6	1.2.1-beta.11	1.2.1-beta.11	v3.x, v4.x, v5.x

Related products

---

These products have their own Helm charts and are not Midaz plugins.

Reporter

Reporter is a standalone product for generating reports from Midaz data.

Chart version	Manager	Worker
3.1.1	2.1.2	2.1.2
2.0.0	1.1.1	1.1.1
1.1.7	4.0.0	4.0.0

Access Manager (shared service)

Access Manager provides authentication and identity services shared across Lerian products.

Chart version	appVersion	Auth	Identity
8.3.0	2.6.7	2.6.7	2.4.5
8.2.0	-	2.6.7	2.4.5
6.0.0	2.3.0	2.4.4	2.1.1
5.2.2	-	2.4.4	2.1.1
4.0.0	-	2.2.0	2.0.0

Product Console

Product Console provides the unified visual interface for Lerian products.

Chart version	Console
3.2.0	1.10.0
3.1.0	1.6.0
2.0.1	1.5.0
1.0.0	1.0.0

OTEL Collector Lerian

OpenTelemetry Collector configured for Lerian’s observability stack.

Chart version	OTEL
4.1.0	0.142.0
2.2.1	2.1.0

Infrastructure dependencies

---

The following table lists the platform prerequisites and the versions of the infrastructure subcharts bundled with the latest Midaz Helm chart. Kubernetes and the Helm CLI are minimum required versions; the data-store and broker rows are the bundled subchart versions, not minimums for an external managed service.

Dependency	Version	Notes
Kubernetes	1.20+	Minimum; 1.30+ recommended
Helm CLI	3.8+	Minimum; required for OCI registry
PostgreSQL	16.3.5	Bundled subchart version — primary database
MongoDB	16.4.0	Bundled subchart version — document storage
RabbitMQ	2.1.11	Bundled subchart version — message broker
Valkey	2.4.7	Bundled subchart version — cache (Redis fork)
OTEL Collector	4.1.0	Separate otel-collector-lerian chart — no longer bundled with the Midaz chart

Version compatibility rules

---

Follow these guidelines to ensure a stable deployment:

• Upgrade Midaz Core first — Always upgrade the main Midaz Helm chart before upgrading any plugins. Plugins depend on Midaz Core APIs.
• Check plugin compatibility — Before upgrading a plugin, verify it’s compatible with your current Midaz version using the tables above.
• Test in staging — Always test new version combinations in a staging environment before deploying to production.
• Review breaking changes — Check the Upgrading Helm guide for breaking changes between major versions.

Helm chart repository

---

All Lerian Helm charts are available from the OCI registry:

# Midaz Core
oci://registry-1.docker.io/lerianstudio/midaz-helm

# Plugins and other products
oci://registry-1.docker.io/lerianstudio/plugin-fees-helm
oci://registry-1.docker.io/lerianstudio/plugin-br-pix-direct-jd
oci://registry-1.docker.io/lerianstudio/plugin-br-pix-indirect-btg-helm
oci://registry-1.docker.io/lerianstudio/plugin-br-bank-transfer-helm
oci://registry-1.docker.io/lerianstudio/reporter
oci://registry-1.docker.io/lerianstudio/plugin-access-manager
oci://registry-1.docker.io/lerianstudio/fetcher-helm
oci://registry-1.docker.io/lerianstudio/tracer-helm

Pix Indirect (BTG)

Chart version	appVersion
3.5.0	1.8.0
3.3.1	1.7.5
2.1.1	1.5.1

Bank Transfer

Chart version	appVersion
2.0.0	2.4.0
1.4.0	2.4.0
1.2.1	1.1.0

Fetcher

Lerian’s internal data-extraction service. Required only when running Reporter or Matcher in managed/multi-tenant mode (FETCHER_ENABLED=true); self-hosted deployments connect directly to datasources and don’t need it. See Infrastructure via Helm.

Chart version	appVersion
3.1.0	3.0.2
3.0.0	1.3.0
2.0.3	1.2.0

Flowker

Chart version	appVersion
3.1.1	1.2.0-beta.82
3.0.0	1.0.0-beta.22
1.0.0	1.0.0

Tracer

Chart version	appVersion
2.1.0	1.0.0
1.0.0	1.0.0

For source code and detailed chart documentation, visit the GitHub repository.