> ## 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 o Midaz via Helm

> Instale o Midaz no Kubernetes com o Helm chart oficial e verifique o release resultante.

<Note>
  Este guia é para times de infraestrutura que operam um deploy em Kubernetes. Para modelos de deploy, consulte [SaaS e BYOC](/pt/start-here/evaluate-and-deploy/deployment-models).
</Note>

O chart do Midaz faz deploy do Ledger por padrão e habilita as dependências Valkey, PostgreSQL, MongoDB e RabbitMQ dele por padrão. O CRM é opcional: o chart define `crm.enabled` como `false`.

<Warning>
  Use a carga de trabalho do Ledger em novas instalações. O chart não faz deploy de cargas de trabalho separadas de onboarding ou transaction.
</Warning>

O OpenTelemetry Collector é um chart separado. O chart do Midaz pode injetar variáveis de conexão do OTEL no Ledger, no CRM e no Tracer, mas não instala um collector.

## Pré-requisitos

* Um cluster Kubernetes compatível com o chart e o ingress controller que você usa.
* Helm 3 instalado localmente.
* `kubectl` instalado e configurado com acesso ao cluster.
* Acesso ao registry que serve o chart e as imagens selecionados.
* Material de DNS e TLS se você configura o ingress.

## Instalar o Midaz

Crie um `values.yaml` que forneça as credenciais exigidas pelo chart antes de instalar. Quando você usa o RabbitMQ empacotado, siga a [configuração de dependências](/pt/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 a instalação

Verifique o release Helm e as cargas de trabalho criadas no namespace:

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

Se uma carga de trabalho não estiver pronta, inspecione os eventos e os logs dela:

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

<Note>
  A quantidade exata de cargas de trabalho depende dos values que você usa, incluindo se você habilita as dependências empacotadas e o CRM opcional.
</Note>

## Próximos passos

* [Configurar o ingress](/pt/platform/deploy/midaz/midaz-ingress)
* [Configurar a observabilidade](/pt/platform/deploy/midaz/midaz-observability)
* [Configurar dependências](/pt/platform/deploy/midaz/midaz-dependencies)
* [Referência de componentes](/pt/platform/deploy/midaz/midaz-components-reference)