> This page is for NVIDIA Studio Voice on Holoscan for Media, version 1.2.0 (Latest) (default).
> For other versions, use one of these documentation indexes:
> - 1.2.0 (Latest) (default): https://docs.nvidia.com/nim/maxine/studio-voice-h4m/1.2.0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nim/maxine/llms.txt.

# Common Helm Configuration

This page covers Helm values that apply to any Studio Voice NIM service chart deployment. The same keys appear under `nvidia-studio-voice-h4m-service.<key>` when the NIM is deployed as part of the end-to-end demo chart.

---

## Global Overrides

Both the NIM service chart and the end-to-end sample (umbrella) chart expose a `global` section. When a global value is non-empty, it overrides the corresponding per-component key for all subcharts (sender, receiver, and NIM service). Leave a value as `""` to use each component's own setting instead.

| Configuration | Helm Key | Overrides | Comment |
|---------------|----------|-----------|---------|
| Node placement | `global.nodeSelector.hostname` | `<component>.nodeSelector.hostname` | Schedule all pods on the same node. |
| Image pull secret | `global.image.secret` | `<component>.image.secret` | Single `docker-registry` secret name for `nvcr.io` across all components. |
| Multus network | `global.network.name` | `<component>.network.name` | `NetworkAttachmentDefinition` name; must match for ST 2110 traffic. |
| Scheduler | `global.schedulerName` | `<component>.schedulerName` | Pod `spec.schedulerName` for all components. |

<Note>
Use `global` values when deploying the umbrella chart so that node selector, pull secret, network, and scheduler need to be specified only once instead of per component.
</Note>

---

## Cluster and Workload

| Configuration | Helm Key | Comment |
|---------------|----------|---------|
| Deploy NIM workload | `enabled` | Default: chart-dependent; set `false` to skip NIM (for example, partial demo chart installation). |
| Name prefix | `appName` | Deployment and pod naming. |
| Replicas | `replicas` | Default: `1` for GPU media functions. |
| Node placement | `nodeSelector.hostname` | Matches `kubernetes.io/hostname` (or cluster labels). |
| Scheduler | `schedulerName` | Default: `topo-aware-scheduler` for NUMA-aligned placement of the GPU, SR-IOV virtual function, and CPU pinning. Override on clusters that lack a topology-aware scheduler (for example, set to `default-scheduler`); the umbrella `global.schedulerName` overrides this setting for all components when non-empty. Refer to [Scheduler and NUMA Topology](/nim/maxine/studio-voice-h4m/getting-started#scheduler-and-numa-topology). |
| Container image | `image.repository`, `image.tag` | Published NIM image. |
| Image pull secret | `image.secret` | `docker-registry` secret name for `nvcr.io`. |
| Container security | `containerSecurityContext.*` | `runAsUser`, `runAsGroup`, `runAsNonRoot`, `allowPrivilegeEscalation`, capabilities. |
| Multus network attachment | `network.name` | Default: `media-a-tx-net`; must match your `NetworkAttachmentDefinition` name. |

---

## NGC and Model Download

| Configuration | Helm Key | Comment |
|---------------|----------|---------|
| Model download secret | `ngc.secretName` | Secret containing `NGC_API_KEY`. |
| Secret key name | `ngc.secretKey` | Default: `NGC_API_KEY`. |

---

## Model Cache and Logs PVCs

| Configuration | Helm Key | Comment |
|---------------|----------|---------|
| Model cache PVC | `nimModelCache.*` | Default path: `/opt/nim/.cache`. |
| NIM logs PVC | `nimLogs.*` | Default path: `/workspace/nim-logs`. |

Subkeys: `enabled`, `create`, `size`, `storageClassName`, `mountPath`, `readOnly`, `subPath`. For configuration examples, refer to [Advanced Usage](/nim/maxine/studio-voice-h4m/advanced-usage#persistent-storage).

---

## NMOS

| Configuration | Helm Key | Environment Variable | Comment |
|---------------|----------|----------------------|---------|
| NMOS discovery mode | `nmos.enabled` | — | `true` or `false`; `false` requires SMPTE ST 2110 static only (fixed IP addresses, ports, sessions). The actual pipeline front-end is controlled by `studiovoice.nmosEnabled` in [Pipeline Configuration](/nim/maxine/studio-voice-h4m/configuration/pipeline). |
| NMOS HTTP port | `nmos.httpPort` | `NVDS_NMOS_DEFAULT_HTTP_PORT` | Default: `9010`. |
| NMOS seed | `nmos.seed` | `NVDS_NMOS_DEFAULT_SEED` | NMOS node seed identifier. |
| Advertised hostname | `nmos.hostname` | `STUDIOVOICE_NMOS_HOSTNAME` | mDNS / NMOS IS-04. |
| Description | `nmos.description` | `STUDIOVOICE_NMOS_DESCRIPTION` | NMOS description string. |
| Label | `nmos.label` | `STUDIOVOICE_NMOS_LABEL` | NMOS label string. |

<Note>
NMOS HTTP port `9010` and the Multus network attachment `media-a-tx-net` are often set in chart templates—confirm for your chart version.
</Note>

---

## Service Endpoints

The NIM service chart and umbrella sample chart create a Kubernetes `Service` for each component that exposes the NMOS Node API (IS-04/IS-05) on port `9010`. Use these to reach the NMOS Connection Manager from outside the pod without `kubectl port-forward`.

| Configuration | Helm Key | Comment |
|---------------|----------|---------|
| Expose endpoint | `service.enabled` | Default: `true`. Set `false` to skip Service creation. |
| Service type | `service.type` | Default: `NodePort`. Supported: `ClusterIP`, `NodePort`, `LoadBalancer`. Use `ClusterIP` for in-cluster access only and `LoadBalancer` when the cluster has an external load balancer. |
| Service port | `service.port` | Default: `9010` (matches `nmos.httpPort`). |
| NodePort | `service.nodePort` | Used only when `service.type: NodePort`. Defaults: `32510` (sender), `32511` (receiver), `32512` (NIM service). |

In the umbrella sample chart, the same keys apply per-component under `sender.service.*`, `receiver.service.*`, and `nvidia-studio-voice-h4m-service.service.*`. The Service name is `<appName>-endpoint`.

Note that the NIM HTTP API endpoints described in [Observability](/nim/maxine/studio-voice-h4m/observability#http-endpoints) (port `8000`, `/v1/health/*`, `/v1/metrics`, and so on) are exposed inside the container and require `kubectl port-forward` for external access; they are not fronted by the chart-managed Service.

---

## See Also

- [Configuration Reference](/nim/maxine/studio-voice-h4m/configuration)
- [Pipeline Configuration](/nim/maxine/studio-voice-h4m/configuration/pipeline) — Studio Voice tuning, model configuration, ST 2110 sessions.
- [Getting Started](/nim/maxine/studio-voice-h4m/getting-started) — Secret creation and high-speed network setup.