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

# Midaz via Helm

> Visão geral do Helm chart do Midaz — instalação, configuração, atualização e solução de problemas.

Esta seção cobre tudo o que você precisa para fazer o deploy e gerenciar o Midaz no Kubernetes usando Helm. Da instalação inicial às atualizações de versão, você encontrará guias adaptados tanto para novos deployments quanto para ambientes existentes.

<Tip>
  Novo no Midaz? Comece com [Instalando o Midaz com Helm](/pt/platform/helm/midaz/midaz-installation) para um passo a passo completo do processo de instalação.
</Tip>

## Por que Helm?

***

Helm é a forma recomendada de fazer o deploy do Midaz no Kubernetes. Ele oferece:

* **Deploy simplificado**: Instale o Midaz com um único comando.
* **Configuração consistente**: Gerencie todas as configurações através de um arquivo centralizado `values.yaml`.
* **Atualizações fáceis**: Atualize versões do Midaz com tempo de inatividade mínimo.
* **Gerenciamento de dependências**: Gerencia automaticamente PostgreSQL, MongoDB, RabbitMQ, Valkey e outros serviços necessários.

## Conteúdo

***

Nesta seção, você encontrará:

* [Instalando o Midaz com Helm](/pt/platform/helm/midaz/midaz-installation): Instale e configure o Midaz no Kubernetes.
* [Configurando o ingress](/pt/platform/helm/midaz/midaz-ingress): Exponha os serviços do Midaz fora do cluster com NGINX, AWS ALB ou Traefik.
* [Configurando a observabilidade](/pt/platform/helm/midaz/midaz-observability): Configure Grafana e OpenTelemetry para monitoramento.
* [Configurando dependências](/pt/platform/helm/midaz/midaz-dependencies): Configure PostgreSQL, MongoDB, RabbitMQ e Valkey.
* [Referência de componentes do Midaz](/pt/platform/helm/midaz/midaz-components-reference): Parâmetros detalhados para os serviços Ledger, Onboarding, Transaction e CRM.
* [Guia de atualização](/pt/platform/helm/midaz/midaz-upgrade-guide): Início rápido para atualizar o Midaz Core e plugins.
* [Guias de migração](/pt/platform/helm/midaz/midaz-migrate-v4-to-v5): Caminhos de migração passo a passo entre versões do Helm chart.
* [Referência de configuração](/pt/platform/helm/midaz/midaz-configuration-reference): Configuração do serviço Ledger, secrets externos e flags de deployment.
* [Checklist de atualização](/pt/platform/helm/midaz/midaz-upgrade-checklist): Boas práticas e verificações pós-atualização.
* [Rollback e solução de problemas](/pt/platform/helm/midaz/midaz-rollback-troubleshooting): Procedimentos de rollback e resolução de problemas comuns.
* [Compatibilidade de versões](/pt/platform/helm/helm-version-compatibility): Consulte a matriz de compatibilidade entre versões do Helm chart e componentes do Midaz.

## Pré-requisitos

***

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

* [**Kubernetes (v1.30+)**](https://kubernetes.io/releases/download/): Um 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).

## Início rápido

***

Para instalar o Midaz usando Helm, execute:

```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. Verifique as versões disponíveis com:

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

<Warning>
  Recomendamos usar a **última versão estável** para deployments em produção para garantir que você tenha as funcionalidades e correções de segurança mais recentes.
</Warning>

Para opções detalhadas de configuração, veja [Instalando o Midaz com Helm](/pt/platform/helm/midaz/midaz-installation).

## Recursos

***

* [Repositório do Helm chart](https://github.com/LerianStudio/helm)
* [Repositório do Midaz](https://github.com/LerianStudio/midaz)
* [Visão geral da arquitetura do Midaz](/pt/midaz/architecture)