Skip to main content
This section covers installing and configuring Midaz on Kubernetes using Helm — from initial deployment to fine-tuning ingress, observability, dependencies, and component parameters.

What you’ll need


  • Kubernetes 1.30+ — Running cluster with kubectl configured.
  • Helm 3+ — Installed locally (helm version to verify).
  • Registry access — Credentials for pulling Midaz container images.
  • DNS and TLS — Domain names and certificates for ingress (or cert-manager for automatic provisioning).

Guides


  • Installation: Install Midaz on Kubernetes with a single Helm command.
  • Ingress: Expose Midaz services outside the cluster using NGINX, AWS ALB, or Traefik.
  • Observability: Set up Grafana and OpenTelemetry for monitoring and tracing.
  • Dependencies: Configure PostgreSQL, MongoDB, RabbitMQ, and Valkey — bundled or external.
  • Components reference: Detailed parameters for Ledger, Onboarding, Transaction, and CRM services.

Quick start


helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version> -n midaz --create-namespace
For step-by-step instructions, see Installation.