> ## 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 Midaz con Helm

> Planifica las migraciones entre versiones mayores del Helm chart de Midaz: elige la ruta de actualización correcta, revisa los cambios incompatibles y prepara antes los datos y la configuración.

<Warning>
  La orientación sobre CRM y Fees marcada como legacy en esta página aplica solo a un release legacy existente. Midaz v4 despliega el Ledger unificado y sirve CRM y Fees en `/v2`.
</Warning>

<Note>
  Los números de versión en esta sección se refieren a **versiones mayores del Helm chart**, no a versiones de la aplicación Midaz. La línea v5 del chart introdujo el workload de Ledger. La aplicación Midaz v4 ahora usa el Ledger unificado sin importar esa numeración histórica del chart.
</Note>

El repositorio de Helm conserva un workload `crm.enabled` y el chart `plugin-fees-helm` para releases de aplicación anteriores. Son superficies de compatibilidad legacy, no el modelo de despliegue de Midaz v4.

Esta sección cubre la migración entre versiones mayores del Helm chart de Midaz, incluidos los cambios incompatibles, los pasos de migración y el mapeo de configuración.

## Rutas de migración

***

***

| Desde | Hasta | Guía                                                                   |
| ----- | ----- | ---------------------------------------------------------------------- |
| v4.x  | v5.x  | [Migrar v4.x → v5.x](/es/platform/deploy/midaz/midaz-migrate-v4-to-v5) |
| v3.x  | v4.x  | [Migrar v3.x → v4.x](/es/platform/deploy/midaz/midaz-migrate-v3-to-v4) |
| v3.x  | v5.x  | [Migrar v3.x → v5.x](/es/platform/deploy/midaz/midaz-migrate-v3-to-v5) |

<Warning>
  **Estas rutas terminan en v5.x.** La línea del chart avanzó. Los saltos
  más allá de v5 traen sus propios cambios incompatibles, en particular:

  * **v7.0.0** eliminó los servicios `onboarding` y `transaction`, la Console y
    NGINX. Onboarding y Transaction se ejecutan en `ledger`. CRM y Tracer siguen siendo workloads opcionales separados.
  * **v8.4.0** ya no instala el subchart `otel-collector-lerian`, y su
    esquema ahora rechaza claves legacy.

  Ninguna página de aquí cubre todavía esos saltos. Lee las notas de actualización del propio chart en
  [`charts/midaz/docs/`](https://github.com/LerianStudio/helm/tree/main/charts/midaz/docs)
  (`UPGRADE-7.0.md`, `UPGRADE-8.x.md`) antes de pasar de v5.x. Consulta la
  [Guía de actualización](/es/platform/deploy/midaz/midaz-upgrade-guide) para el procedimiento de
  actualización actual.
</Warning>

## ¿Qué ruta debo elegir?

***

* **v4.x → v5.x**: la más común. Introduce el servicio de Ledger unificado y la integración con CRM.
* **v3.x → v4.x**: cambio de la dependencia de RabbitMQ (Bitnami → Groundhog2k) e imágenes de BitnamiSecure.
* **v3.x → v5.x**: salto directo que resuelve los cambios incompatibles de v4.x y v5.x en una sola actualización.

<Tip>
  Para actualizaciones rutinarias dentro de la misma versión mayor, consulta [Actualizar Midaz con Helm](/es/platform/deploy/midaz/midaz-upgrading-overview).
</Tip>