# Helm Values Reference

This is the list of configuration parameters used in the AGENTIC STAR marketplace Helm charts.

The "Source" column for each parameter indicates how the value is set.

| Source                 | Description                                                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------------- |
| **Fixed**              | Default fixed value. Typically no change needed                                                          |
| **UI Input**           | Value specified in the deployment form at purchase time                                                  |
| **Auto-Retrieved**     | Automatically retrieved from Azure resources during deployment                                           |
| **Auto-Generated**     | Randomly generated secret created during deployment                                                      |
| **config.yaml**        | Set from the installer's `config.yaml` (not shown on the marketplace creation screen)                    |
| **Open/close command** | Set only when an administrator opens or closes the entrance with `kc_direct_login.sh` after installation |

## Overview of Auto-Retrieved & Auto-Generated Parameters

Each service section below lists the source per parameter, but to verify "did everything get set correctly?" after deployment, use the consolidated tables here. In particular, **`librechat-env-secret`** is the main application's central secret bundle; most of its values are auto-retrieved or auto-generated by the installer.

### Auto-Retrieved Parameters (Azure)

| Parameter                                                                                                           | Source                                                                                                                                                                                                                    | Primary location                                                |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| `global.azure.subscriptionId`                                                                                       | `az account show`                                                                                                                                                                                                         | Each service ConfigMap                                          |
| `global.azure.resourceGroupName`                                                                                    | ARM template                                                                                                                                                                                                              | Each service ConfigMap                                          |
| `aks.nodeResourceGroup`                                                                                             | `az aks show --query nodeResourceGroup`                                                                                                                                                                                   | Each service ConfigMap                                          |
| `global.postgresql.host`                                                                                            | PostgreSQL Flexible Server FQDN                                                                                                                                                                                           | `*-env-secret`                                                  |
| `global.postgresql.database`                                                                                        | ARM template output                                                                                                                                                                                                       | `*-env-secret`                                                  |
| `global.objectStorage.azure.connectionString`                                                                       | `az storage account show-connection-string` (Private Storage)                                                                                                                                                             | `librechat-env-secret` (key: `AZURE_STORAGE_CONNECTION_STRING`) |
| `global.objectStorage.azure.storageAccountName`                                                                     | ARM template                                                                                                                                                                                                              | ConfigMap                                                       |
| `global.objectStorage.azure.customDomain`                                                                           | `<storageAccountName>.blob.core.windows.net`                                                                                                                                                                              | ConfigMap                                                       |
| `publicStorage.connectionString`                                                                                    | `az storage account show-connection-string` (Public Storage)                                                                                                                                                              | Public storage Secret                                           |
| `appConfig.authBaseUrl` / `domainClient` / `domainServer`                                                           | Set automatically from the address of each LoadBalancer (to change to your own domain, see the [Domain Settings Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/build/guide/domain-guide.md)) | `librechat-env-secret`, ConfigMap                               |
| `env.APP_URL` / `LIBRECHAT_URL` / `ADMIN_CONSOLE_URL`                                                               | Same as above                                                                                                                                                                                                             | `librechat-auth-secret`, `agenticai-admin-secret`               |
| `env.WEBAUTHN_RP_ID`                                                                                                | Derived from the auth domain                                                                                                                                                                                              | `librechat-auth-secret`                                         |
| `env.ALLOWED_ORIGINS` / `AFD_CHATBOARD_FRONT_AUTH_DOMAIN` / `AFD_CHATBOARD_ADMIN_DOMAIN` / `CHATBOARD_FRONT_DOMAIN` | Derived from domain settings                                                                                                                                                                                              | `extauth-service` ConfigMap                                     |
| `internalHosts.storageHosts`                                                                                        | Internal storage FQDNs                                                                                                                                                                                                    | `extauth-service` ConfigMap                                     |

> **On AWS**
>
> - Object storage is S3 (`global.objectStorage.provider` is `aws`). The bucket and region created by the CloudFormation stack are set automatically and stored as `AWS_BUCKET_NAME` and `AWS_REGION` in the `librechat-env` ConfigMap. No access keys are used; the Pods read and write with the IAM role assigned to them
> - The PostgreSQL host is the RDS endpoint, and the user name and password specified when creating the stack are set automatically
> - `global.azure.*`, `aks.nodeResourceGroup`, `global.objectStorage.azure.*` and `publicStorage.connectionString` in the table are not used

### Auto-Generated Parameters (random secrets)

Keys and passwords used for authentication and encryption between the applications are generated automatically at installation as random values unique to each environment, and stored in each service's Secret. Do not change them manually (changing them can make stored data unreadable or break communication between services).

### Verification After Deployment

To confirm the deployment completed correctly, read the object storage settings on Kubernetes.

```bash
# Azure: check AZURE_STORAGE_CONNECTION_STRING
kubectl get secret librechat-env-secret -n agentic-star-front \
  -o jsonpath='{.data.AZURE_STORAGE_CONNECTION_STRING}' | base64 -d
```

On Azure, a value of the form `DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net` means it is correct.

```bash
# AWS: check the S3 bucket name
kubectl get configmap librechat-env -n agentic-star-front \
  -o jsonpath='{.data.AWS_BUCKET_NAME}'
```

On AWS, the name of the bucket created by the CloudFormation stack means it is correct.

> **caution**
>
> If the value is empty, starts with `CHANGE_ME_*`, or looks like `<placeholder>`, the installer may have failed to retrieve the value from the cloud resources. See the [Deployment Troubleshooting Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/build/guide/troubleshooting-guide.md) or contact support.

## Common Settings (common-values)

Settings shared across all services.

### Environment Settings

| Parameter                    | Default | Source   | Description                                                                                                  |
| ---------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| `global.environment`         | —       | UI Input | Environment name                                                                                             |
| `global.customerEnvironment` | —       | UI Input | Same value as Environment Name                                                                               |
| `global.primary.language`    | `ja`    | UI Input | UI display language (ja / en / fr / es / th / ar / id / zh-Hans / zh-Hant / pt-BR / de-DE / it-IT / vi / ko) |

### Container Registry

| Parameter                         | Default | Source | Description              |
| --------------------------------- | ------- | ------ | ------------------------ |
| `global.imagePullSecret.enabled`  | `false` | Fixed  | Enable image pull secret |
| `global.imagePullSecret.name`     | `""`    | Fixed  | Secret name              |
| `global.imagePullSecret.registry` | `""`    | Fixed  | Registry URL             |

### PostgreSQL

| Parameter                          | Default | Source         | Description                  |
| ---------------------------------- | ------- | -------------- | ---------------------------- |
| `global.postgresql.host`           | —       | Auto-Retrieved | PostgreSQL server FQDN       |
| `global.postgresql.port`           | `5432`  | Fixed          | Port number                  |
| `global.postgresql.database`       | —       | Auto-Retrieved | Database name                |
| `global.postgresql.username`       | —       | UI Input       | Administrator username       |
| `global.postgresql.password`       | —       | UI Input       | Administrator password       |
| `global.postgresql.useAzureAd`     | `false` | Fixed          | Use Azure AD authentication  |
| `global.postgresql.poolMinSize`    | `5`     | Fixed          | Connection pool minimum size |
| `global.postgresql.poolMaxSize`    | `20`    | Fixed          | Connection pool maximum size |
| `global.postgresql.commandTimeout` | `60`    | Fixed          | Command timeout (seconds)    |
| `global.postgresql.poolTimeout`    | `30`    | Fixed          | Pool timeout (seconds)       |
| `global.postgresql.maxOverflow`    | `10`    | Fixed          | Maximum overflow connections |

### Azure Settings

| Parameter                        | Default | Source         | Description           |
| -------------------------------- | ------- | -------------- | --------------------- |
| `global.azure.subscriptionId`    | —       | Auto-Retrieved | Azure subscription ID |
| `global.azure.resourceGroupName` | —       | Auto-Retrieved | Resource group name   |

### Object Storage

| Parameter                                       | Default                  | Source         | Description               |
| ----------------------------------------------- | ------------------------ | -------------- | ------------------------- |
| `global.objectStorage.provider`                 | `azure`                  | Fixed          | Storage provider          |
| `global.objectStorage.azure.container`          | `autonomous-agent-files` | Fixed          | Azure Blob container name |
| `global.objectStorage.azure.connectionString`   | —                        | Auto-Retrieved | Connection string         |
| `global.objectStorage.azure.storageAccountName` | —                        | Auto-Retrieved | Storage account name      |
| `global.objectStorage.azure.customDomain`       | —                        | Auto-Retrieved | Custom domain             |

### Ingress TLS

| Parameter                           | Default               | Source | Description                 |
| ----------------------------------- | --------------------- | ------ | --------------------------- |
| `global.ingress.tls.enabled`        | `true`                | Fixed  | Enable TLS                  |
| `global.ingress.tls.secretName`     | `selfsigned-tls-cert` | Fixed  | TLS certificate Secret name |
| `global.ingress.tls.useCertManager` | `false`               | Fixed  | Use cert-manager            |
| `global.ingress.tls.clusterIssuer`  | `""`                  | Fixed  | ClusterIssuer name          |

### Kubernetes

| Parameter                          | Default            | Source | Description           |
| ---------------------------------- | ------------------ | ------ | --------------------- |
| `global.kubernetes.namespace`      | `autonomous-agent` | Fixed  | Default Namespace     |
| `global.kubernetes.serviceAccount` | `default`          | Fixed  | Service account name  |
| `global.kubernetes.rbac.create`    | `true`             | Fixed  | Create RBAC resources |

## Main Application (librechat)

| Parameter                          | Default                  | Source                    | Description                              |
| ---------------------------------- | ------------------------ | ------------------------- | ---------------------------------------- |
| `image.tag`                        | —                        | Fixed (version-dependent) | Image tag                                |
| `global.domain`                    | `front.agentic.internal` | Fixed                     | Internal domain                          |
| `vectordb.enabled`                 | `true`                   | Fixed                     | Enable vector DB                         |
| `nginx-ingress.enabled`            | `false`                  | Fixed                     | Disable built-in Ingress (uses existing) |
| `appConfig.buildMode`              | `mp`                     | Fixed                     | Build mode (marketplace)                 |
| `appConfig.authBaseUrl`            | —                        | Auto-Retrieved            | Authentication service URL               |
| `appConfig.domainClient`           | —                        | Auto-Retrieved            | Client domain                            |
| `appConfig.domainServer`           | —                        | Auto-Retrieved            | Server domain                            |
| `appConfig.jwtSecret`              | —                        | Auto-Generated            | JWT secret                               |
| `appConfig.jwtRefreshSecret`       | —                        | Auto-Generated            | JWT refresh secret                       |
| `appConfig.credsKey`               | —                        | Auto-Generated            | Credential encryption key                |
| `appConfig.credsIv`                | —                        | Auto-Generated            | Credential encryption IV                 |
| `appConfig.tokenEncryptionKey`     | —                        | Auto-Generated            | Token encryption key                     |
| `appConfig.searchSyncSecret`       | —                        | Auto-Generated            | Search sync secret                       |
| `appConfig.gateApiKey`             | —                        | Auto-Generated            | Gate API key                             |
| `appConfig.extApiKey`              | —                        | Auto-Generated            | External API key                         |
| `appConfig.extApiWebhookSecret`    | —                        | Auto-Generated            | Webhook secret                           |
| `appConfig.cspImgSrcAdditional`    | `""`                     | —                         | Additional CSP img-src domains           |
| `appConfig.webpushVapidPublicKey`  | `""`                     | —                         | WebPush VAPID public key                 |
| `appConfig.webpushVapidPrivateKey` | `""`                     | —                         | WebPush VAPID private key                |
| `appConfig.webpushVapidEmail`      | `""`                     | —                         | WebPush VAPID contact email address      |
| `mongodb.podAntiAffinityPreset`    | `soft`                   | Fixed                     | MongoDB AntiAffinity                     |
| `api.hpa.minReplicas`              | `1`                      | Fixed                     | Minimum replica count                    |

## Authentication Service (librechat-auth)

| Parameter                         | Default        | Source                    | Description                            |
| --------------------------------- | -------------- | ------------------------- | -------------------------------------- |
| `image.tag`                       | —              | Fixed (version-dependent) | Image tag                              |
| `env.APP_URL`                     | —              | Auto-Retrieved            | Authentication service URL             |
| `env.LIBRECHAT_URL`               | —              | Auto-Retrieved            | Main application URL                   |
| `env.ADMIN_CONSOLE_URL`           | —              | Auto-Retrieved            | Admin console URL                      |
| `env.KEYCLOAK_REALM`              | `agenticstar`  | Fixed                     | Keycloak realm name                    |
| `env.KEYCLOAK_ADMIN`              | `admin`        | Fixed                     | Keycloak administrator name            |
| `env.POSTGRES_DB`                 | `keycloak_db`  | Fixed                     | Keycloak database name                 |
| `env.BUILD_MODE`                  | `mp`           | Fixed                     | Build mode                             |
| `env.EMAIL_AUTH_ENABLED`          | `true`         | Fixed                     | Enable authentication email            |
| `env.NEXT_PUBLIC_REQUIRE_OAUTH`   | `true`         | Fixed                     | Require OAuth                          |
| `env.WEBAUTHN_RP_NAME`            | `AGENTIC STAR` | Fixed                     | WebAuthn display name                  |
| `env.WEBAUTHN_RP_ID`              | —              | Auto-Retrieved            | WebAuthn RP ID (authentication domain) |
| `secrets.JWT_SECRET`              | —              | Auto-Generated            | JWT secret                             |
| `secrets.TOKEN_ENCRYPTION_KEY`    | —              | Auto-Generated            | Token encryption key                   |
| `secrets.KEYCLOAK_ADMIN_PASSWORD` | —              | Auto-Generated            | Keycloak administrator password        |
| `secrets.KEYCLOAK_CLIENT_SECRET`  | —              | Auto-Generated            | Keycloak client secret                 |
| `autoscaling.minReplicas`         | `1`            | Fixed                     | Minimum replica count                  |
| `keycloakx.replicas`              | `1`            | Fixed                     | Keycloak replica count                 |

### External Entrance of the Authorization Server (keycloak-extensions)

These values are set only while the external entrance of the authorization server (release `keycloak-extensions`, Namespace `librechat-auth`) is open ([Domain Settings Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/build/guide/domain-guide.md#kc-direct-login)). They are set by `keycloak.direct_login_address` in the installer's `config.yaml` (empty = closed (default), `auto`, or a domain) or by `kc_direct_login.sh open` after installation, and removed by `close`. Use the same names when running `helm upgrade` by hand.

| Parameter                                                                                         | Value when open                                                         | Source                               | Description                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `keycloakx.secrets.direct-login.stringData.AGENTIC_STAR_KC_EXTERNAL_URL`                          | `https://<external address>`                                            | Open/close command                   | The URL the authorization server announces externally. Closing removes the whole Secret                                                                                           |
| `keycloakx.extraEnvFrom`                                                                          | `- secretRef:` `name: {{ include "keycloak.fullname" . }}-direct-login` | Open/close command                   | Loads the Secret above as environment variables. Empty when closed                                                                                                                |
| `keycloakx.proxy.mode`                                                                            | `xforwarded`                                                            | Open/close command                   | Identifies external requests by the `X-Forwarded-*` headers. Reverts to `forwarded` (chart default) when closed                                                                   |
| `keycloakx.ingress.enabled`                                                                       | `true`                                                                  | Open/close command                   | The external entrance (Ingress). `false` when closed                                                                                                                              |
| `keycloakx.ingress.ingressClassName`                                                              | `nginx`                                                                 | Open/close command                   | Ingress class                                                                                                                                                                     |
| `keycloakx.ingress.rules[0].host`                                                                 | `kc.agentic.internal`                                                   | Open/close command                   | Internal name of the entrance (same form as the other 4 endpoints). Holds the 12 exposed paths in `paths`                                                                         |
| `keycloakx.ingress.annotations."nginx.ingress.kubernetes.io/server-alias"`                        | `<external address>`                                                    | Open/close command                   | Alias of the entrance. Replaced when the address changes                                                                                                                          |
| `keycloakx.ingress.annotations."nginx.ingress.kubernetes.io/ssl-redirect"` `…/force-ssl-redirect` | Same values as the authentication service Ingress                       | Open/close command (first time only) | Copied from the authentication service Ingress the first time the entrance is opened. Values you change afterwards are kept                                                       |
| `keycloakx.ingress.annotations."nginx.ingress.kubernetes.io/proxy-buffer-size"`                   | `128k`                                                                  | Open/close command (first time only) | Prevents 502 errors when the authorization server's response headers are large                                                                                                    |
| `keycloakx.ingress.tls[0].hosts`                                                                  | `[kc.agentic.internal]`                                                 | Open/close command (first time only) | TLS hosts. Changed by you in [Methods 1–3](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/build/guide/domain-guide.md#choosing-an-ssl-configuration-method) |
| `keycloakx.ingress.tls[0].secretName`                                                             | Same Secret name as the authentication service Ingress                  | Open/close command (first time only) | `selfsigned-tls-cert` as shipped. With cert-manager, use a name different from the authentication service (`app-tls-cert-kc`)                                                     |

> **note**
>
> The Ingress of the authorization server does not read the `global.ingress.tls.*` values used by the other services. Pass TLS settings and annotations directly under `keycloakx.ingress.*` above.

## Admin Console (agenticai-admin)

| Parameter                             | Default       | Source                    | Description                                                                                                                                                                   |
| ------------------------------------- | ------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `image.tag`                           | —             | Fixed (version-dependent) | Image tag                                                                                                                                                                     |
| `env.GEO_BLOCKING_EXCLUDED_COUNTRIES` | `JP`          | Fixed                     | Geo-blocking excluded countries (ISO 3166-1)                                                                                                                                  |
| `env.ALLOWED_ORIGINS`                 | —             | Auto-Retrieved            | Allowed origins                                                                                                                                                               |
| `env.AFD_CHATBOARD_FRONT_AUTH_DOMAIN` | —             | Auto-Retrieved            | Authentication and front domain                                                                                                                                               |
| `env.AFD_CHATBOARD_ADMIN_DOMAIN`      | —             | Auto-Retrieved            | Admin console domain                                                                                                                                                          |
| `env.CHATBOARD_FRONT_DOMAIN`          | —             | Auto-Retrieved            | Front domain                                                                                                                                                                  |
| `env.MP_INBOUND_MCP_A2A_ENABLED`      | `"false"`     | config.yaml               | Whether the inbound endpoints (MCP / A2A) of the external API are open. Set to the same value as `extapi.inbound_mcp_a2a` ([Opening the inbound endpoints](#inbound-mcp-a2a)) |
| `secrets.KEYCLOAK_DB`                 | `keycloak_db` | Fixed                     | Keycloak database name                                                                                                                                                        |
| `secrets.TOKEN_ENCRYPTION_KEY`        | —             | Auto-Generated            | Token encryption key                                                                                                                                                          |
| `replicaCount`                        | `1`           | Fixed                     | Replica count                                                                                                                                                                 |
| `autoscaling.minReplicas`             | `1`           | Fixed                     | Minimum replica count                                                                                                                                                         |
| `rbac.create`                         | `true`        | Fixed                     | Create RBAC resources                                                                                                                                                         |

## Agent Execution Platform (agent-executor)

| Parameter                 | Default | Source                    | Description                                                   |
| ------------------------- | ------- | ------------------------- | ------------------------------------------------------------- |
| `image.tag`               | —       | Fixed (version-dependent) | Image tag                                                     |
| `memory.graphiti.enabled` | `false` | Fixed                     | Enable Graphiti memory (disabled as FalkorDB is not included) |
| `deployment.replicas`     | `1`     | Fixed                     | Replica count                                                 |
| `hpa.minReplicas`         | `1`     | Fixed                     | HPA minimum replica count                                     |

## External API (agenticai-extapi)

| Parameter                       | Default                                                      | Source                    | Description                                                                                                                                                                                                                                   |
| ------------------------------- | ------------------------------------------------------------ | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `image.tag`                     | —                                                            | Fixed (version-dependent) | Image tag                                                                                                                                                                                                                                     |
| `config.LOG_LEVEL`              | `INFO`                                                       | Fixed                     | Log level                                                                                                                                                                                                                                     |
| `config.APIGW_PUBLIC_URL`       | `https://<external API domain>`                              | Auto-Retrieved            | Public URL of the inbound endpoints (MCP server / A2A server). Used for the Agent Card URL and artifact URIs                                                                                                                                  |
| `config.A2A_PUBLIC_URL`         | `https://<external API domain>`                              | Auto-Retrieved            | Public URL of the A2A server                                                                                                                                                                                                                  |
| `config.MP_OAUTH_TOKEN_URL`     | `https://<authentication service domain>/api/v1/oauth/token` | Auto-Retrieved            | Standard token endpoint for service accounts (client\_credentials) shown in the A2A Agent Card                                                                                                                                                |
| `config.MP_DIRECT_LOGIN_ISSUER` | `""`                                                         | Open/close command        | Issuer of tokens from the external entrance of the authorization server, `https://<external address>/realms/<realm>`. Set only while open; empty again when closed ([External entrance of the authorization server](#kc-direct-login-values)) |
| `mpInbound.enabled`             | `false`                                                      | config.yaml               | Gate of the inbound endpoints (MCP server / A2A server). The value of `extapi.inbound_mcp_a2a` ([Opening the inbound endpoints](#inbound-mcp-a2a))                                                                                            |
| `secrets.CBF_S2S_API_KEY`       | —                                                            | Auto-Generated            | S2S API key                                                                                                                                                                                                                                   |
| `secrets.WEBHOOK_SECRET`        | —                                                            | Auto-Generated            | Webhook secret                                                                                                                                                                                                                                |
| `replicaCount`                  | `1`                                                          | Fixed                     | Replica count                                                                                                                                                                                                                                 |
| `autoscaling.minReplicas`       | `1`                                                          | Fixed                     | Minimum replica count                                                                                                                                                                                                                         |

### Opening the Inbound Endpoints (MCP Server / A2A Server)

The inbound endpoints of the external API (MCP server `POST /api/v1/mcp`, A2A server `POST /api/v1/a2a/agents/{agentId}`) are **closed by default** (`404 Not Found`). When opened, external AI clients and third-party agents can call Agents with a service account token (client\_credentials). For users to use MCP with their own account, also open the [external entrance of the authorization server](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/build/guide/domain-guide.md#kc-direct-login).

| Where                                                                     | Value                      | Description                                                                                                                                                            |
| ------------------------------------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `extapi.inbound_mcp_a2a` in `config.yaml`                                 | `false` (default) / `true` | The installer sets the two values below to this value. Unset or empty also means `false`                                                                               |
| `mpInbound.enabled` of the external API (`agenticai-extapi`)              | `false` / `true`           | Gate of the inbound endpoints                                                                                                                                          |
| `env.MP_INBOUND_MCP_A2A_ENABLED` of the admin console (`agenticai-admin`) | `"false"` / `"true"`       | Shows the MCP / A2A rows in the Agent's "How to call" section of the admin console. With `false`, it shows that the administrator has not opened the inbound endpoints |

Prerequisites for opening:

- A custom domain and a valid certificate are configured for the external API domain (`domain.extapi`); external clients cannot connect with the shipped self-signed certificate
- Restricting source addresses (such as allowing specific source IPs) is the purchaser's responsibility
- The Agents to be called have a `WEBHOOK_URL` and use the SDK's marketplace handler (required for streaming responses)

To open after installation, update both the external API and the admin console (specify the chart version currently deployed, as shown by `HELM_DRIVER=configmap helm list -A`).

```bash
# External API: open the inbound endpoints
HELM_DRIVER=configmap helm upgrade agenticai-extapi agenticai-prod/agenticai-extapi \
  --version 3.3.0 --reuse-values \
  --set mpInbound.enabled=true \
  -n agenticai-extapi-service

# Admin console: show MCP / A2A in "How to call"
HELM_DRIVER=configmap helm upgrade agenticai-admin agenticai-prod/agenticai-admin \
  --version 3.3.0 --reuse-values \
  --set-string env.MP_INBOUND_MCP_A2A_ENABLED=true \
  -n agentic-star-admin
```

To close, run the same commands with `false`. For usage, see the [MCP Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/mcp-ref.md) and the [A2A Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/a2a-ref.md).

## Gateway (gate-services)

| Parameter                       | Default | Source                    | Description                      |
| ------------------------------- | ------- | ------------------------- | -------------------------------- |
| `image.tag`                     | —       | Fixed (version-dependent) | Image tag                        |
| `appConfig.defaultFromName`     | `""`    | Fixed                     | Email sender name                |
| `secrets.apiKey`                | —       | Auto-Generated            | Gate API key                     |
| `secrets.encryptionKey`         | —       | Auto-Generated            | Encryption key                   |
| `secrets.azureConnectionString` | `""`    | Fixed                     | Azure connection string (unused) |
| `replicaCount`                  | `1`     | Fixed                     | Replica count                    |
| `autoscaling.minReplicas`       | `1`     | Fixed                     | Minimum replica count            |

## Zero-Trust Authorization Service (extauth-service)

| Parameter                        | Default  | Source                    | Description                                         |
| -------------------------------- | -------- | ------------------------- | --------------------------------------------------- |
| `image.tag`                      | —        | Fixed (version-dependent) | Image tag                                           |
| `webhook.enabled`                | `true`   | Fixed                     | Enable Webhook                                      |
| `webhook.image.tag`              | —        | Fixed (version-dependent) | Webhook image tag                                   |
| `webhook.replicaCount`           | `1`      | Fixed                     | Webhook replica count                               |
| `webhook.pdb.enabled`            | `false`  | Fixed                     | Enable Webhook PDB                                  |
| `webhook.mutating.failurePolicy` | `Ignore` | Fixed                     | Webhook failure policy                              |
| `webhook.affinity`               | `null`   | Fixed                     | AntiAffinity disabled (single replica)              |
| `cert-manager.enabled`           | `false`  | Fixed                     | Disable cert-manager (already installed separately) |
| `cert-manager.installCRDs`       | `false`  | Fixed                     | Disable CRD installation                            |
| `replicaCount`                   | `1`      | Fixed                     | Replica count                                       |
| `autoscaling.minReplicas`        | `1`      | Fixed                     | Minimum replica count                               |
| `pdb.enabled`                    | `false`  | Fixed                     | Enable PDB                                          |
| `affinity`                       | `null`   | Fixed                     | AntiAffinity disabled (single replica)              |
| `internalHosts.storageHosts`     | —        | Auto-Retrieved            | Internal storage hostnames                          |

> **tip**
>
> For instructions on changing replica counts, PDB, and failurePolicy for security hardening, see the [Security Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/build/guide/security-guide.md).

## Vector DB (qdrant)

| Parameter                       | Default | Source | Description         |
| ------------------------------- | ------- | ------ | ------------------- |
| `qdrant.replicaCount`           | `1`     | Fixed  | Replica count       |
| `qdrant.config.cluster.enabled` | `false` | Fixed  | Enable cluster mode |
| `loadBalancer.enabled`          | `false` | Fixed  | Enable LoadBalancer |
| `dashboard.enabled`             | `false` | Fixed  | Enable dashboard    |

> **danger**
>
> `loadBalancer.enabled` and `dashboard.enabled` must be set to `false` in production environments. Enabling them allows external access, creating a risk of data leakage.

## Database Migration (db-migration)

| Parameter                   | Default       | Source                    | Description                        |
| --------------------------- | ------------- | ------------------------- | ---------------------------------- |
| `image.tag`                 | —             | Fixed (version-dependent) | Image tag                          |
| `secrets.create`            | `true`        | Fixed                     | Auto-create Secrets                |
| `secrets.keycloakDb`        | `keycloak_db` | Fixed                     | Keycloak database name             |
| `jobs.migrate.enabled`      | `true`        | Fixed                     | Enable migration job               |
| `jobs.migrate.backoffLimit` | `0`           | Fixed                     | Retry count                        |
| `jobs.migrate.target`       | `head`        | Fixed                     | Migration target                   |
| `jobs.downgrade.enabled`    | `false`       | Fixed                     | Enable downgrade job               |
| `masterData.enabled`        | `true`        | Fixed                     | Enable master data seeding         |
| `qdrant.enabled`            | `true`        | Fixed                     | Enable Qdrant initial data seeding |

## Services Not Listed

The values for the following services are not included in this reference. These are monitoring and infrastructure services whose settings typically do not need to be changed by users.

| Service                        | Description                 |
| ------------------------------ | --------------------------- |
| **kube-prometheus-stack**      | Prometheus monitoring stack |
| **prometheus-adapter**         | Custom metrics API          |
| **ingress-nginx**              | Ingress controller          |
| **loki**                       | Log storage                 |
| **alloy-logs / alloy-metrics** | Log and metrics collectors  |
| **k8s-monitoring**             | Kubernetes monitoring       |
| **agenticai-observability**    | Grafana / Jaeger            |
| **agenticai-datadog**          | Datadog integration         |
| **pvc-lifecycle-manager**      | PVC lifecycle management    |
| **init-platform**              | Platform initialization job |

To view the settings for these services, run `helm get values <release-name> -n <namespace>` to check the current values.
