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

# Lerian Console vía Helm

> Referencia de instalación del Helm chart y de compatibilidad de versiones para desplegar el Lerian Console en Kubernetes, con values de configuración y orientación de actualización.

Lerian Console es la interfaz web unificada para gestionar productos Lerian. Provee dashboards para operaciones del ledger, gestión de cuentas, monitoreo de transacciones y configuración de plugins a través de una sola UI.

## Qué instala el chart

***

El chart instala una carga de trabajo web: un Deployment, un Service, un ConfigMap, un Secret y un ServiceAccount. Agrega un Ingress, un HorizontalPodAutoscaler y un PodDisruptionBudget cuando habilitas cada uno de ellos.

El chart incluye un subchart de MongoDB y lo habilita de forma predeterminada. La Console guarda ahí sus propios datos. Define `mongodb.enabled: false` para apuntar la Console a un MongoDB gestionado externamente.

## Requisitos previos

***

* Un despliegue de Midaz en ejecución. Las rutas de servicio de ejemplo de abajo suponen que instalas Midaz en el namespace `midaz`. Si usas otro namespace, sobrescribe los FQDN según corresponda.
* Access Manager desplegado (para la autenticación).
* Helm 3.8 o posterior para el soporte de registry OCI. Usa una [versión menor de Kubernetes con soporte vigente](https://kubernetes.io/releases/) en producción.

## Configuración clave

***

El chart trae rutas de API predeterminadas que apuntan a los servicios `midaz-onboarding` y `midaz-transaction`. El chart de Midaz quitó ambos servicios en v7.0.0, así que debes definir las rutas tú mismo. Apúntalas al servicio Ledger:

```yaml theme={null}
configmap:
  MIDAZ_BASE_PATH: "http://midaz-ledger.midaz.svc.cluster.local:3002/v1"
  MIDAZ_TRANSACTION_BASE_PATH: "http://midaz-ledger.midaz.svc.cluster.local:3002/v1"
```

Define las credenciales en el bloque `secrets`, o apunta el release a tu propio Secret con `useExistingSecret`. El chart trae `NEXTAUTH_SECRET`, `MONGODB_PASS` y `PLUGIN_AUTH_CLIENT_SECRET` vacíos.

## Values de configuración públicos

***

El chart actual expone estos values `NEXT_PUBLIC_*` en su ConfigMap. Defínelos en tu archivo de values para el entorno que despliegas.

| Value                                             | Predeterminado del chart |
| :------------------------------------------------ | :----------------------- |
| `NEXT_PUBLIC_MIDAZ_CONSOLE_AVATAR_ALLOWED_FORMAT` | `jpeg,jpg,png,svg`       |
| `NEXT_PUBLIC_PLUGIN_AUTH_ENABLED`                 | `false`                  |
| `NEXT_PUBLIC_MIDAZ_VERSION`                       | vacío                    |

## Registry OCI

***

```bash theme={null}
oci://registry-1.docker.io/lerianstudio/product-console-helm
```

## Instalación

***

Lee la versión actual del chart y la versión de aplicación que despliega antes de instalar:

```bash theme={null}
helm show chart oci://registry-1.docker.io/lerianstudio/product-console-helm
```

```bash theme={null}
helm install console oci://registry-1.docker.io/lerianstudio/product-console-helm --version <version> -n console --create-namespace -f my-values.yaml
```

## Actualización y desinstalación

***

```bash theme={null}
helm upgrade console oci://registry-1.docker.io/lerianstudio/product-console-helm \
  --version <new-version> -n console -f my-values.yaml
```

```bash theme={null}
helm uninstall console -n console
```

Desinstalar quita los recursos de Kubernetes. Revisa los ajustes de almacenamiento del subchart de MongoDB incluido antes de desinstalar, y respalda los datos que quieras conservar.

## Recursos

***

* [Documentación de Lerian Console](/es/platform/console/about-lerian-console)
* [Repositorio del Helm chart](https://github.com/LerianStudio/helm)