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:
Examples:
midaz-v4.4.8 - Midaz Helm chart version 4.4.8plugin-crm-v3.2.1 - CRM plugin chart version 3.2.1plugin-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.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 |
|---|
| 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.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 |
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.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.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 | 2.2.1 | Bundled subchart version — optional |
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:
Pix Indirect (BTG)
| Chart version | appVersion |
|---|
| 3.3.1 | 1.7.5 |
| 2.1.1 | 1.5.1 |
Bank Transfer
| Chart version | appVersion |
|---|
| 1.2.1 | 1.0.0 |
| 1.1.0 | 2.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.0.0 | 1.4.2 |
| 2.0.3 | 1.2.0 |
Flowker
| Chart version | appVersion |
|---|
| 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 |
