Skip to main content

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.

SourceDescription
FixedDefault fixed value. Typically no change needed
UI InputValue specified in the deployment form at purchase time
Auto-RetrievedAutomatically retrieved from Azure resources during deployment
Auto-GeneratedRandomly generated secret created during deployment
config.yamlSet from the installer's config.yaml (not shown on the marketplace creation screen)
Open/close commandSet 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)​

ParameterSourcePrimary location
global.azure.subscriptionIdaz account showEach service ConfigMap
global.azure.resourceGroupNameARM templateEach service ConfigMap
aks.nodeResourceGroupaz aks show --query nodeResourceGroupEach service ConfigMap
global.postgresql.hostPostgreSQL Flexible Server FQDN*-env-secret
global.postgresql.databaseARM template output*-env-secret
global.objectStorage.azure.connectionStringaz storage account show-connection-string (Private Storage)librechat-env-secret (key: AZURE_STORAGE_CONNECTION_STRING)
global.objectStorage.azure.storageAccountNameARM templateConfigMap
global.objectStorage.azure.customDomain<storageAccountName>.blob.core.windows.netConfigMap
publicStorage.connectionStringaz storage account show-connection-string (Public Storage)Public storage Secret
appConfig.authBaseUrl / domainClient / domainServerSet automatically from the address of each LoadBalancer (to change to your own domain, see the Domain Settings Guide)librechat-env-secret, ConfigMap
env.APP_URL / LIBRECHAT_URL / ADMIN_CONSOLE_URLSame as abovelibrechat-auth-secret, agenticai-admin-secret
env.WEBAUTHN_RP_IDDerived from the auth domainlibrechat-auth-secret
env.ALLOWED_ORIGINS / AFD_CHATBOARD_FRONT_AUTH_DOMAIN / AFD_CHATBOARD_ADMIN_DOMAIN / CHATBOARD_FRONT_DOMAINDerived from domain settingsextauth-service ConfigMap
internalHosts.storageHostsInternal storage FQDNsextauth-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.

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

curl
# 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 or contact support.

Common Settings (common-values)​

Settings shared across all services.

Environment Settings​

ParameterDefaultSourceDescription
global.environment—UI InputEnvironment name
global.customerEnvironment—UI InputSame value as Environment Name
global.primary.languagejaUI InputUI display language (ja / en / fr / es / th / ar / id / zh-Hans / zh-Hant / pt-BR / de-DE / it-IT / vi / ko)

Container Registry​

ParameterDefaultSourceDescription
global.imagePullSecret.enabledfalseFixedEnable image pull secret
global.imagePullSecret.name""FixedSecret name
global.imagePullSecret.registry""FixedRegistry URL

PostgreSQL​

ParameterDefaultSourceDescription
global.postgresql.host—Auto-RetrievedPostgreSQL server FQDN
global.postgresql.port5432FixedPort number
global.postgresql.database—Auto-RetrievedDatabase name
global.postgresql.username—UI InputAdministrator username
global.postgresql.password—UI InputAdministrator password
global.postgresql.useAzureAdfalseFixedUse Azure AD authentication
global.postgresql.poolMinSize5FixedConnection pool minimum size
global.postgresql.poolMaxSize20FixedConnection pool maximum size
global.postgresql.commandTimeout60FixedCommand timeout (seconds)
global.postgresql.poolTimeout30FixedPool timeout (seconds)
global.postgresql.maxOverflow10FixedMaximum overflow connections

Azure Settings​

ParameterDefaultSourceDescription
global.azure.subscriptionId—Auto-RetrievedAzure subscription ID
global.azure.resourceGroupName—Auto-RetrievedResource group name

Object Storage​

ParameterDefaultSourceDescription
global.objectStorage.providerazureFixedStorage provider
global.objectStorage.azure.containerautonomous-agent-filesFixedAzure Blob container name
global.objectStorage.azure.connectionString—Auto-RetrievedConnection string
global.objectStorage.azure.storageAccountName—Auto-RetrievedStorage account name
global.objectStorage.azure.customDomain—Auto-RetrievedCustom domain

Ingress TLS​

ParameterDefaultSourceDescription
global.ingress.tls.enabledtrueFixedEnable TLS
global.ingress.tls.secretNameselfsigned-tls-certFixedTLS certificate Secret name
global.ingress.tls.useCertManagerfalseFixedUse cert-manager
global.ingress.tls.clusterIssuer""FixedClusterIssuer name

Kubernetes​

ParameterDefaultSourceDescription
global.kubernetes.namespaceautonomous-agentFixedDefault Namespace
global.kubernetes.serviceAccountdefaultFixedService account name
global.kubernetes.rbac.createtrueFixedCreate RBAC resources

Main Application (librechat)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
global.domainfront.agentic.internalFixedInternal domain
vectordb.enabledtrueFixedEnable vector DB
nginx-ingress.enabledfalseFixedDisable built-in Ingress (uses existing)
appConfig.buildModempFixedBuild mode (marketplace)
appConfig.authBaseUrl—Auto-RetrievedAuthentication service URL
appConfig.domainClient—Auto-RetrievedClient domain
appConfig.domainServer—Auto-RetrievedServer domain
appConfig.jwtSecret—Auto-GeneratedJWT secret
appConfig.jwtRefreshSecret—Auto-GeneratedJWT refresh secret
appConfig.credsKey—Auto-GeneratedCredential encryption key
appConfig.credsIv—Auto-GeneratedCredential encryption IV
appConfig.tokenEncryptionKey—Auto-GeneratedToken encryption key
appConfig.searchSyncSecret—Auto-GeneratedSearch sync secret
appConfig.gateApiKey—Auto-GeneratedGate API key
appConfig.extApiKey—Auto-GeneratedExternal API key
appConfig.extApiWebhookSecret—Auto-GeneratedWebhook 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.podAntiAffinityPresetsoftFixedMongoDB AntiAffinity
api.hpa.minReplicas1FixedMinimum replica count

Authentication Service (librechat-auth)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
env.APP_URL—Auto-RetrievedAuthentication service URL
env.LIBRECHAT_URL—Auto-RetrievedMain application URL
env.ADMIN_CONSOLE_URL—Auto-RetrievedAdmin console URL
env.KEYCLOAK_REALMagenticstarFixedKeycloak realm name
env.KEYCLOAK_ADMINadminFixedKeycloak administrator name
env.POSTGRES_DBkeycloak_dbFixedKeycloak database name
env.BUILD_MODEmpFixedBuild mode
env.EMAIL_AUTH_ENABLEDtrueFixedEnable authentication email
env.NEXT_PUBLIC_REQUIRE_OAUTHtrueFixedRequire OAuth
env.WEBAUTHN_RP_NAMEAGENTIC STARFixedWebAuthn display name
env.WEBAUTHN_RP_ID—Auto-RetrievedWebAuthn RP ID (authentication domain)
secrets.JWT_SECRET—Auto-GeneratedJWT secret
secrets.TOKEN_ENCRYPTION_KEY—Auto-GeneratedToken encryption key
secrets.KEYCLOAK_ADMIN_PASSWORD—Auto-GeneratedKeycloak administrator password
secrets.KEYCLOAK_CLIENT_SECRET—Auto-GeneratedKeycloak client secret
autoscaling.minReplicas1FixedMinimum replica count
keycloakx.replicas1FixedKeycloak 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). 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.

ParameterValue when openSourceDescription
keycloakx.secrets.direct-login.stringData.AGENTIC_STAR_KC_EXTERNAL_URLhttps://<external address>Open/close commandThe URL the authorization server announces externally. Closing removes the whole Secret
keycloakx.extraEnvFrom- secretRef:
name: {{ include "keycloak.fullname" . }}-direct-login
Open/close commandLoads the Secret above as environment variables. Empty when closed
keycloakx.proxy.modexforwardedOpen/close commandIdentifies external requests by the X-Forwarded-* headers. Reverts to forwarded (chart default) when closed
keycloakx.ingress.enabledtrueOpen/close commandThe external entrance (Ingress). false when closed
keycloakx.ingress.ingressClassNamenginxOpen/close commandIngress class
keycloakx.ingress.rules[0].hostkc.agentic.internalOpen/close commandInternal 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 commandAlias 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 IngressOpen/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"128kOpen/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
keycloakx.ingress.tls[0].secretNameSame Secret name as the authentication service IngressOpen/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)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
env.GEO_BLOCKING_EXCLUDED_COUNTRIESJPFixedGeo-blocking excluded countries (ISO 3166-1)
env.ALLOWED_ORIGINS—Auto-RetrievedAllowed origins
env.AFD_CHATBOARD_FRONT_AUTH_DOMAIN—Auto-RetrievedAuthentication and front domain
env.AFD_CHATBOARD_ADMIN_DOMAIN—Auto-RetrievedAdmin console domain
env.CHATBOARD_FRONT_DOMAIN—Auto-RetrievedFront domain
env.MP_INBOUND_MCP_A2A_ENABLED"false"config.yamlWhether 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)
secrets.KEYCLOAK_DBkeycloak_dbFixedKeycloak database name
secrets.TOKEN_ENCRYPTION_KEY—Auto-GeneratedToken encryption key
replicaCount1FixedReplica count
autoscaling.minReplicas1FixedMinimum replica count
rbac.createtrueFixedCreate RBAC resources

Agent Execution Platform (agent-executor)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
memory.graphiti.enabledfalseFixedEnable Graphiti memory (disabled as FalkorDB is not included)
deployment.replicas1FixedReplica count
hpa.minReplicas1FixedHPA minimum replica count

External API (agenticai-extapi)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
config.LOG_LEVELINFOFixedLog level
config.APIGW_PUBLIC_URLhttps://<external API domain>Auto-RetrievedPublic URL of the inbound endpoints (MCP server / A2A server). Used for the Agent Card URL and artifact URIs
config.A2A_PUBLIC_URLhttps://<external API domain>Auto-RetrievedPublic URL of the A2A server
config.MP_OAUTH_TOKEN_URLhttps://<authentication service domain>/api/v1/oauth/tokenAuto-RetrievedStandard token endpoint for service accounts (client_credentials) shown in the A2A Agent Card
config.MP_DIRECT_LOGIN_ISSUER""Open/close commandIssuer 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)
mpInbound.enabledfalseconfig.yamlGate of the inbound endpoints (MCP server / A2A server). The value of extapi.inbound_mcp_a2a (Opening the inbound endpoints)
secrets.CBF_S2S_API_KEY—Auto-GeneratedS2S API key
secrets.WEBHOOK_SECRET—Auto-GeneratedWebhook secret
replicaCount1FixedReplica count
autoscaling.minReplicas1FixedMinimum 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.

WhereValueDescription
extapi.inbound_mcp_a2a in config.yamlfalse (default) / trueThe installer sets the two values below to this value. Unset or empty also means false
mpInbound.enabled of the external API (agenticai-extapi)false / trueGate 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).

curl
# 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 and the A2A Reference.

Gateway (gate-services)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
appConfig.defaultFromName""FixedEmail sender name
secrets.apiKey—Auto-GeneratedGate API key
secrets.encryptionKey—Auto-GeneratedEncryption key
secrets.azureConnectionString""FixedAzure connection string (unused)
replicaCount1FixedReplica count
autoscaling.minReplicas1FixedMinimum replica count

Zero-Trust Authorization Service (extauth-service)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
webhook.enabledtrueFixedEnable Webhook
webhook.image.tag—Fixed (version-dependent)Webhook image tag
webhook.replicaCount1FixedWebhook replica count
webhook.pdb.enabledfalseFixedEnable Webhook PDB
webhook.mutating.failurePolicyIgnoreFixedWebhook failure policy
webhook.affinitynullFixedAntiAffinity disabled (single replica)
cert-manager.enabledfalseFixedDisable cert-manager (already installed separately)
cert-manager.installCRDsfalseFixedDisable CRD installation
replicaCount1FixedReplica count
autoscaling.minReplicas1FixedMinimum replica count
pdb.enabledfalseFixedEnable PDB
affinitynullFixedAntiAffinity disabled (single replica)
internalHosts.storageHosts—Auto-RetrievedInternal storage hostnames
tip

For instructions on changing replica counts, PDB, and failurePolicy for security hardening, see the Security Guide.

Vector DB (qdrant)​

ParameterDefaultSourceDescription
qdrant.replicaCount1FixedReplica count
qdrant.config.cluster.enabledfalseFixedEnable cluster mode
loadBalancer.enabledfalseFixedEnable LoadBalancer
dashboard.enabledfalseFixedEnable 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)​

ParameterDefaultSourceDescription
image.tag—Fixed (version-dependent)Image tag
secrets.createtrueFixedAuto-create Secrets
secrets.keycloakDbkeycloak_dbFixedKeycloak database name
jobs.migrate.enabledtrueFixedEnable migration job
jobs.migrate.backoffLimit0FixedRetry count
jobs.migrate.targetheadFixedMigration target
jobs.downgrade.enabledfalseFixedEnable downgrade job
masterData.enabledtrueFixedEnable master data seeding
qdrant.enabledtrueFixedEnable 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.

ServiceDescription
kube-prometheus-stackPrometheus monitoring stack
prometheus-adapterCustom metrics API
ingress-nginxIngress controller
lokiLog storage
alloy-logs / alloy-metricsLog and metrics collectors
k8s-monitoringKubernetes monitoring
agenticai-observabilityGrafana / Jaeger
agenticai-datadogDatadog integration
pvc-lifecycle-managerPVC lifecycle management
init-platformPlatform initialization job

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