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

# Instalación de Midaz vía Helm

> Instala Midaz en Kubernetes con el chart oficial de Helm — Ledger, bases de datos y stack de observabilidad en un único comando.

<Tip>
  **Esta página está dirigida a ingenieros DevOps y equipos de infraestructura.** Cubre la configuración de despliegue en Kubernetes usando charts de Helm. Si buscas una comprensión de alto nivel de las opciones de despliegue de Midaz, consulta [SaaS y BYOC](/es/deployment-models).
</Tip>

Esta es la forma recomendada de desplegar Midaz en Kubernetes. El chart de Helm instala todo lo necesario en un solo comando: el servicio core Ledger (o los legacy Onboarding/Transaction), PostgreSQL, MongoDB, Valkey, RabbitMQ y un stack de observabilidad opcional (Grafana + OpenTelemetry).

<Warning>
  **Usa el servicio Ledger para todas las nuevas instalaciones.** Los servicios separados de Onboarding y Transaction solo están soportados para escenarios de migración y serán deprecados en una futura versión.
</Warning>

<Note>
  Esta guía cubre el chart de Helm de Midaz v5.x. Para actualizar desde versiones anteriores, consulta [Actualización de Helm](/es/platform/helm/midaz/midaz-upgrade-guide).
</Note>

## Qué se despliega

***

Un `helm install` predeterminado despliega los siguientes componentes:

* **Ledger** — Servicio API unificado (puerto 3002) que gestiona onboarding, transacciones y administración de cuentas.
* **PostgreSQL** — Primario + réplica para almacenamiento de datos relacionales (puerto 5432).
* **MongoDB** — Almacén de documentos para logs de auditoría y metadatos (puerto 27017).
* **Valkey** — Caché en memoria para datos de sesión y balances (puerto 6379).
* **RabbitMQ** — Broker de mensajes para procesamiento asíncrono de eventos (puertos 5672/15672).
* **Grafana + OTEL LGTM** — Stack de observabilidad con dashboards, logs, traces y métricas (puerto 3000, si está habilitado).

## Requisitos previos

Antes de desplegar Midaz con Helm, asegúrate de tener:

* [**Kubernetes (v1.30+)**](https://kubernetes.io/releases/download/) – Clúster en ejecución.
* [**Helm 3+**](https://helm.sh/docs/intro/install/) – Instalado y disponible (`helm version`).
* Acceso a un registro de contenedores con imágenes de Midaz.
* Certificados DNS y TLS para ingress (o cert-manager instalado).

<Note>
  El código fuente de este chart de Helm está disponible en:

  * [midaz-helm](https://github.com/LerianStudio/helm/tree/main/charts/midaz)
  * [midaz](https://github.com/LerianStudio/midaz)

  La instalación predeterminada coincide con la proporcionada en la [guía de instalación rápida de Midaz](https://github.com/LerianStudio/midaz?tab=readme-ov-file#quick-installation-guide-localhost).
</Note>

¿Quieres una comprensión más profunda de la arquitectura? Consulta el [resumen de la arquitectura de Midaz](/es/midaz/architecture).

## Instalar Midaz a través del chart de Helm

Para instalar Midaz usando Helm, ejecuta el siguiente comando:

```bash theme={null}
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version> -n midaz --create-namespace
```

Reemplaza `<version>` con la versión deseada del chart de Helm. Puedes verificar las versiones disponibles ejecutando:

```bash theme={null}
helm search repo oci://registry-1.docker.io/lerianstudio/midaz-helm --versions
```

Esto crea un namespace llamado `midaz` (si no existe ya) y despliega el chart.

<Tip>
  El chart de Helm está en nuestro [repositorio de GitHub](https://github.com/LerianStudio/helm). Puedes hacer un fork, personalizar los valores o extenderlo según sea necesario.
</Tip>

## Verificar la instalación

***

Después de ejecutar el comando de instalación, verifica que todos los pods estén en ejecución:

```bash theme={null}
kubectl get pods -n midaz
kubectl get svc -n midaz
```

<Note>
  **Resultado esperado:** Deberías ver 5-7 pods en estado `Running` (Ledger, PostgreSQL primario, PostgreSQL réplica, MongoDB, Valkey, RabbitMQ y opcionalmente Grafana). Todos los servicios deben tener endpoints `ClusterIP` asignados. Si algún pod está en `CrashLoopBackOff` o `Pending`, revisa los logs del pod con `kubectl logs <pod-name> -n midaz`.
</Note>

Para confirmar que el release de Helm está registrado:

```bash theme={null}
helm list -n midaz
```

## Próximos pasos

***

Una vez completada la instalación, consulta las siguientes guías para configurar tu entorno:

* [Configurar ingress](/es/platform/helm/midaz/midaz-ingress): Expón servicios de Midaz fuera del clúster usando controladores ingress.
* [Configurar observabilidad](/es/platform/helm/midaz/midaz-observability): Habilita Grafana y OpenTelemetry para monitoreo y trazabilidad.
* [Configurar dependencias](/es/platform/helm/midaz/midaz-dependencies): Gestiona PostgreSQL, MongoDB, RabbitMQ, Valkey y otras dependencias externas.
* [Referencia de componentes](/es/platform/helm/midaz/midaz-components-reference): Consulta la referencia completa de parámetros para los servicios Ledger, Onboarding, Transaction y CRM.