> ## 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.

# Migrar o Midaz via Helm

> Planeje migrações entre versões maiores do Helm chart do Midaz: escolha o caminho de upgrade certo, revise as mudanças incompatíveis e prepare dados e configuração antes.

<Warning>
  As orientações de CRM e Fees marcadas como legado nesta página valem apenas para um release legado existente. O Midaz v4 faz deploy do Ledger unificado e serve CRM e Fees em `/v2`.
</Warning>

<Note>
  Os números de versão desta seção referem-se a **versões maiores do Helm chart**, não a versões da aplicação Midaz. A linha v5 do chart introduziu a carga de trabalho do Ledger. A aplicação Midaz v4 agora usa o Ledger unificado, independentemente dessa numeração histórica de chart.
</Note>

O repositório Helm mantém uma carga de trabalho `crm.enabled` e o chart `plugin-fees-helm` para releases de aplicação mais antigos. Essas são superfícies de compatibilidade legadas, não o modelo de deploy do Midaz v4.

Esta seção cobre a migração entre versões maiores do Helm chart do Midaz, incluindo mudanças incompatíveis, etapas de migração e mapeamento de configuração.

## Caminhos de migração

***

***

| De   | Para | Guia                                                                   |
| ---- | ---- | ---------------------------------------------------------------------- |
| v4.x | v5.x | [Migrar v4.x → v5.x](/pt/platform/deploy/midaz/midaz-migrate-v4-to-v5) |
| v3.x | v4.x | [Migrar v3.x → v4.x](/pt/platform/deploy/midaz/midaz-migrate-v3-to-v4) |
| v3.x | v5.x | [Migrar v3.x → v5.x](/pt/platform/deploy/midaz/midaz-migrate-v3-to-v5) |

<Warning>
  **Estes caminhos param na v5.x.** A linha do chart avançou. Os saltos
  além da v5 trazem mudanças incompatíveis próprias, com destaque para:

  * **v7.0.0** removeu os serviços `onboarding` e `transaction`, o Console e o
    NGINX. Onboarding e Transaction rodam em `ledger`. CRM e Tracer continuam como cargas de trabalho opcionais separadas.
  * **v8.4.0** não instala mais o subchart `otel-collector-lerian`, e o
    schema dele agora rejeita chaves legadas.

  Nenhuma página aqui cobre esses saltos ainda. Leia as notas de upgrade do próprio chart em
  [`charts/midaz/docs/`](https://github.com/LerianStudio/helm/tree/main/charts/midaz/docs)
  (`UPGRADE-7.0.md`, `UPGRADE-8.x.md`) antes de passar da v5.x. Consulte o
  [Guia de upgrade](/pt/platform/deploy/midaz/midaz-upgrade-guide) para o procedimento
  de upgrade atual.
</Warning>

## Qual caminho devo escolher?

***

* **v4.x → v5.x**: o mais comum. Introduz o serviço Ledger unificado e a integração de CRM.
* **v3.x → v4.x**: mudança da dependência RabbitMQ (Bitnami → Groundhog2k) e imagens BitnamiSecure.
* **v3.x → v5.x**: salto direto que trata as mudanças incompatíveis da v4.x e da v5.x em um único upgrade.

<Tip>
  Para upgrades rotineiros dentro da mesma versão maior, consulte [Fazer upgrade do Midaz Helm](/pt/platform/deploy/midaz/midaz-upgrading-overview).
</Tip>