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

# Helm documentation improvement

> The Helm documentation now lives under the Platform tab as a product-organized reference covering installation, upgrades, migration, troubleshooting, and production configuration.

<Badge stroke icon="calendar-days" iconType="regular">April 10, 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Documentation update</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Review recommended</Badge>

## Affects

***

Teams using Helm deployment documentation.

This update applies to the public documentation portal. It does not change the runtime API behavior unless the linked product documentation says otherwise.

## What changed

***

The Helm documentation received a full restructure this week. What was previously a handful of monolithic pages is now a product-organized reference covering installation, upgrading, migration, troubleshooting, and production configuration.

### New structure: Helm by product

***

The Helm section has been reorganized under the Platform tab and grouped by product, so you can jump straight to the reference for what you're deploying.

* [**Helm overview**](/en/platform/helm/helm-overview) — Central hub linking to all product-specific Helm documentation
* [**Version compatibility**](/en/platform/helm/helm-version-compatibility) — Updated matrix with OCI registry docs and chart versioning clarification

### Midaz (16 new pages)

The Midaz Helm documentation was split from two large pages into focused, navigable sections:

* **Install & Configure** — [Installation](/en/platform/helm/midaz/midaz-installation), [Configuration reference](/en/platform/helm/midaz/midaz-configuration-reference), [Dependencies](/en/platform/helm/midaz/midaz-dependencies), [Ingress](/en/platform/helm/midaz/midaz-ingress), [Components reference](/en/platform/helm/midaz/midaz-components-reference)
* **Upgrading** — [Upgrade guide](/en/platform/helm/midaz/midaz-upgrade-guide), [Upgrade checklist](/en/platform/helm/midaz/midaz-upgrade-checklist)
* **Migrating** — [v3 → v4](/en/platform/helm/midaz/midaz-migrate-v3-to-v4), [v4 → v5](/en/platform/helm/midaz/midaz-migrate-v4-to-v5), [v3 → v5](/en/platform/helm/midaz/midaz-migrate-v3-to-v5)
* **Operations** — [Troubleshooting](/en/platform/helm/midaz/midaz-troubleshooting), [Rollback & troubleshooting](/en/platform/helm/midaz/midaz-rollback-troubleshooting), [Observability](/en/platform/helm/midaz/midaz-observability), [Uninstall](/en/platform/helm/midaz/midaz-uninstall)
* **Production** — [Production values reference](/en/platform/helm/midaz/midaz-production-values) — Complete annotated values.yaml for production deployments

### Plugins (7 new pages)

Each plugin now has its own Helm reference page:

* [**Plugins overview**](/en/platform/helm/plugins/plugins-helm-overview)
* [Pix](/en/platform/helm/plugins/plugin-pix-helm), [Pix Indirect](/en/platform/helm/plugins/plugin-pix-indirect-helm), [CRM](/en/platform/helm/plugins/plugin-crm-helm), [Fees](/en/platform/helm/plugins/plugin-fees-helm), [Bank Transfer](/en/platform/helm/plugins/plugin-bank-transfer-helm)

### Other products (4 new pages)

* [**Reporter**](/en/platform/helm/reporter/reporter-helm)
* [**Console**](/en/platform/helm/console/console-helm)
* [**Access Manager**](/en/platform/helm/access-manager/access-manager-helm)
* [**Infrastructure**](/en/platform/helm/infrastructure/infrastructure-helm)

### New: Deployment Models page

***

A new [**SaaS and BYOC**](/en/deployment-models) page explains the two deployment models (fully managed SaaS vs. Bring Your Own Cloud), including when to use each, what Helm means in the BYOC context, and links to all product-specific Helm documentation.

### Removed pages

The following monolithic pages were removed and their content redistributed into the new structure:

* `helm-overview.mdx` (old Midaz section) — replaced by [Platform Helm overview](/en/platform/helm/helm-overview) and [Midaz Helm overview](/en/platform/helm/midaz/midaz-helm-overview)
* `helm-upgrade-guide.mdx` — replaced by dedicated [Upgrade guide](/en/platform/helm/midaz/midaz-upgrade-guide) and migration pages
* `upgrading-helm.mdx` — content merged into the upgrade guide and checklist

### Content improvements

* **Business context** — Helm pages now include decision context and "why this matters" framing, not just configuration instructions
* **Production guidance** — New production values reference with annotated production values and resource recommendations
* **Troubleshooting** — Comprehensive symptom-based troubleshooting covering pods, ingress, databases, RabbitMQ, and Helm operations
* **Migration paths** — Detailed step-by-step migration guides for every supported version transition (v3→v4, v4→v5, v3→v5) with breaking changes and rollback procedures
* **Navigation** — Sentence case applied to all Helm headers, cleaned up duplicated links from deployment pages
* **Network ports** — Updated [default network ports](/en/reference/default-network-ports) reference

## Impact

***

This is a documentation update. Existing integrations do not need a migration from this release note alone.

## What you need to do

***

<Steps>
  <Step>
    Use the product-organized Helm documentation when planning installation, upgrade, migration, troubleshooting, or production configuration.
  </Step>
</Steps>

### Deadline

None.

### Why

The Helm documentation moved to a Platform structure and was reorganized by product.