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

# Instalação do Midaz via Helm

> Instale o Midaz no Kubernetes com o Helm chart oficial — Ledger, bancos de dados e stack de observabilidade em um único comando.

<Tip>
  **Esta página é destinada a engenheiros DevOps e equipes de infraestrutura.** Ela cobre a configuração de deploy no Kubernetes usando Helm charts. Se você está procurando uma visão de alto nível sobre as opções de deploy do Midaz, veja [SaaS e BYOC](/pt/deployment-models).
</Tip>

Esta é a forma recomendada de fazer deploy do Midaz no Kubernetes. O Helm chart instala tudo que você precisa em um único comando: o serviço core Ledger (ou os legacy Onboarding/Transaction), PostgreSQL, MongoDB, Valkey, RabbitMQ e um stack de observabilidade opcional (Grafana + OpenTelemetry).

<Warning>
  **Use o serviço Ledger para todas as novas instalações.** Os serviços separados de Onboarding e Transaction são suportados apenas para cenários de migração e serão deprecados em uma futura versão.
</Warning>

<Note>
  Este guia cobre o Helm chart do Midaz v5.x. Para atualizar a partir de versões anteriores, veja [Atualizando o Helm](/pt/platform/helm/midaz/midaz-upgrade-guide).
</Note>

## O que é implantado

***

Um `helm install` padrão implanta os seguintes componentes:

* **Ledger** — Serviço de API unificado (porta 3002) que gerencia onboarding, transações e administração de contas.
* **PostgreSQL** — Primário + réplica para armazenamento de dados relacionais (porta 5432).
* **MongoDB** — Armazenamento de documentos para logs de auditoria e metadados (porta 27017).
* **Valkey** — Cache em memória para dados de sessão e saldos (porta 6379).
* **RabbitMQ** — Broker de mensagens para processamento assíncrono de eventos (portas 5672/15672).
* **Grafana + OTEL LGTM** — Stack de observabilidade com dashboards, logs, traces e métricas (porta 3000, se habilitado).

## Pré-requisitos

Antes de fazer o deploy do Midaz com Helm, certifique-se de ter:

* [**Kubernetes (v1.30+)**](https://kubernetes.io/releases/download/) – Cluster em execução.
* [**Helm 3+**](https://helm.sh/docs/intro/install/) – Instalado e disponível (`helm version`).
* Acesso a um registro de containers com as imagens do Midaz.
* Certificados DNS e TLS para ingress (ou cert-manager instalado).

<Note>
  O código-fonte deste Helm chart está disponível em:

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

  A instalação padrão corresponde à fornecida no [Guia de instalação rápida do Midaz](https://github.com/LerianStudio/midaz?tab=readme-ov-file#quick-installation-guide-localhost).
</Note>

Quer entender melhor a arquitetura? Confira a [Visão geral da arquitetura do Midaz](/pt/midaz/architecture).

## Instalar o Midaz via Helm Chart

Para instalar o Midaz usando Helm, execute o seguinte comando:

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

Substitua `<version>` pela versão desejada do Helm chart. Você pode verificar as versões disponíveis executando:

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

Isso cria um namespace chamado `midaz` (se ainda não existir) e faz o deploy do chart.

<Tip>
  O Helm chart está no nosso [repositório GitHub](https://github.com/LerianStudio/helm). Você pode fazer fork, personalizar valores ou estender conforme necessário.
</Tip>

## Verificar a instalação

***

Após executar o comando de instalação, verifique se todos os pods estão em execução:

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

<Note>
  **Resultado esperado:** Você deve ver 5-7 pods no estado `Running` (Ledger, PostgreSQL primário, PostgreSQL réplica, MongoDB, Valkey, RabbitMQ e opcionalmente Grafana). Todos os serviços devem ter endpoints `ClusterIP` atribuídos. Se algum pod estiver em `CrashLoopBackOff` ou `Pending`, verifique os logs do pod com `kubectl logs <pod-name> -n midaz`.
</Note>

Para confirmar que o release do Helm está registrado:

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

## Próximos passos

***

Depois de instalar o Midaz, consulte os guias a seguir para configurar seu ambiente:

* [Configurando o ingress](/pt/platform/helm/midaz/midaz-ingress): Exponha os serviços do Midaz fora do cluster usando NGINX, AWS ALB ou Traefik.
* [Configurando a observabilidade](/pt/platform/helm/midaz/midaz-observability): Habilite telemetria e dashboards com Grafana e OpenTelemetry.
* [Configurando dependências](/pt/platform/helm/midaz/midaz-dependencies): Configure Valkey, PostgreSQL, MongoDB e RabbitMQ para o Midaz.
* [Referência de componentes](/pt/platform/helm/midaz/midaz-components-reference): Consulte todos os parâmetros de configuração dos serviços Ledger, Onboarding, Transaction e CRM.