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

# Instalar Midaz con Helm

> Instala Midaz en Kubernetes con el Helm chart oficial y verifica el release resultante.

<Note>
  Esta guía es para equipos de infraestructura que operan un despliegue de Kubernetes. Para conocer los modelos de despliegue, consulta [SaaS y BYOC](/es/start-here/evaluate-and-deploy/deployment-models).
</Note>

El chart de Midaz despliega Ledger de forma predeterminada y habilita sus dependencias de Valkey, PostgreSQL, MongoDB y RabbitMQ de forma predeterminada. CRM es opcional: el chart define `crm.enabled` como `false`.

<Warning>
  Usa el workload de Ledger para instalaciones nuevas. El chart no despliega workloads separados de onboarding o transaction.
</Warning>

El OpenTelemetry Collector es un chart separado. El chart de Midaz puede inyectar variables de conexión OTEL en Ledger, CRM y Tracer, pero no instala un collector.

## Requisitos previos

* Un cluster de Kubernetes compatible con el chart y el ingress controller que uses.
* Helm 3 instalado localmente.
* `kubectl` instalado y configurado con acceso al cluster.
* Acceso al registry que sirve el chart y las imágenes seleccionados.
* Material de DNS y TLS si configuras ingress.

## Instalar Midaz

Crea un `values.yaml` que provea las credenciales que requiere el chart antes de instalar. Cuando usas el RabbitMQ incluido, sigue la [configuración de dependencias](/es/platform/deploy/midaz/midaz-dependencies#bundled-rabbitmq).

```bash theme={null}
CHART_VERSION=replace-with-chart-version
helm show chart oci://registry-1.docker.io/lerianstudio/midaz-helm --version "$CHART_VERSION"
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --version "$CHART_VERSION" -n midaz --create-namespace -f values.yaml
```

## Verificar la instalación

Revisa el Helm release y los workloads creados en el namespace:

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

Si un workload no está listo, inspecciona sus eventos y logs:

```bash theme={null}
kubectl get events -n midaz --sort-by=.lastTimestamp
kubectl logs deployment/midaz-ledger -n midaz
```

<Note>
  La cantidad exacta de workloads depende de los values que uses, incluido si habilitas las dependencias incluidas y el CRM opcional.
</Note>

## Próximos pasos

* [Configurar ingress](/es/platform/deploy/midaz/midaz-ingress)
* [Configurar observabilidad](/es/platform/deploy/midaz/midaz-observability)
* [Configurar dependencias](/es/platform/deploy/midaz/midaz-dependencies)
* [Referencia de componentes](/es/platform/deploy/midaz/midaz-components-reference)