Fees via Helm

Deploy the standalone Fees service on Kubernetes with the plugin-fees-helm chart, including its required secrets and its MongoDB dependency.

In Midaz v4, the unified Ledger contains Fees as a module and serves it on /v2. The plugin-fees-helm chart deploys the standalone Fees service that application releases before v4 expect. Deploy this chart only when you operate one of those releases.

What the chart installs

---

The chart installs one Fees workload: a Deployment, a Service, a ConfigMap, a Secret, a ServiceAccount, a HorizontalPodAutoscaler, a PodDisruptionBudget, and an optional Ingress. It also runs a MongoDB bootstrap job.

The chart bundles a MongoDB subchart and enables it by default. Set mongodb.enabled: false to point the service at an externally managed MongoDB instead.

Prerequisites

---

• A running Midaz deployment.
• The plugin-access-manager chart, when you set fees.configmap.PLUGIN_AUTH_ENABLED to true. The chart disables that flag by default.
• A valid Lerian Enterprise license.
• Helm 3.8 or later for OCI registry support.

Install

---

helm install plugin-fees oci://registry-1.docker.io/lerianstudio/plugin-fees-helm \
  --version <version> -n midaz-plugins --create-namespace -f my-values.yaml

Read the current chart version first:

helm show chart oci://registry-1.docker.io/lerianstudio/plugin-fees-helm

Values you must set

---

Put every credential in fees.secrets, or point the release at your own Secret with fees.useExistingSecret. Set these keys:

Key	When it is required
CLIENT_SECRET	Always. It pairs with CLIENT_ID, which sits beside it in fees.secrets.
LICENSE_KEY	Always, in production.
ORGANIZATION_IDS	Always. It scopes the license to your organizations.
MULTI_TENANT_SERVICE_API_KEY	When you enable multi-tenancy.
MULTI_TENANT_REDIS_PASSWORD	When you enable multi-tenancy.

Leave the MongoDB password empty while the bundled subchart is enabled. The subchart generates it into its own Secret, and the service reads it from there. Set fees.secrets.MONGO_PASSWORD only for an external MongoDB that has no existing Secret of its own.

Upgrade and uninstall

---

helm upgrade plugin-fees oci://registry-1.docker.io/lerianstudio/plugin-fees-helm \
  --version <new-version> -n midaz-plugins -f my-values.yaml

helm uninstall plugin-fees -n midaz-plugins

Uninstalling removes the Kubernetes resources. It does not delete the MongoDB PersistentVolumeClaims. Delete those separately when you want to reclaim the storage.

Resources

---

• Plugin Helm charts
• Helm chart repository