> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating Midaz via Helm

> Plan migrations between major Midaz Helm chart versions — pick the right path and review breaking changes before upgrading.

This section covers migrating between major versions of the Midaz Helm chart, including breaking changes, migration steps, and configuration mapping.

## Migration paths

***

| From | To   | Guide                                                                 |
| ---- | ---- | --------------------------------------------------------------------- |
| v4.x | v5.x | [Migrate v4.x → v5.x](/en/platform/helm/midaz/midaz-migrate-v4-to-v5) |
| v3.x | v4.x | [Migrate v3.x → v4.x](/en/platform/helm/midaz/midaz-migrate-v3-to-v4) |
| v3.x | v5.x | [Migrate v3.x → v5.x](/en/platform/helm/midaz/midaz-migrate-v3-to-v5) |

## Which path should I choose?

***

* **v4.x → v5.x**: Most common. Introduces the unified Ledger service and CRM integration.
* **v3.x → v4.x**: RabbitMQ dependency change (Bitnami → Groundhog2k) and BitnamiSecure images.
* **v3.x → v5.x**: Direct jump that addresses both v4.x and v5.x breaking changes in a single upgrade.

<Tip>
  For routine upgrades within the same major version, see [Upgrading Midaz Helm](/en/platform/helm/midaz/midaz-upgrading-overview).
</Tip>