> This page is for NVIDIA LipSync on Holoscan for Media, version 1.0.0 (Latest) (default).
> For other versions, use one of these documentation indexes:
> - 1.0.0 (Latest) (default): https://docs.nvidia.com/nim/maxine/lipsync-h4m/1.0.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 LipSync NIM service chart deployment. The same keys appear under `nvidia-lipsync-h4m-service.<key>` when the NIM is deployed as part of the [End-to-End Demo Chart](/nim/maxine/lipsync-h4m/installation/lipsync-h4m-sample).

---

## 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. See [High-Speed Network Configuration](/nim/maxine/lipsync-h4m/getting-started#high-speed-network-configuration). |
| Scheduler | `global.schedulerName` | `<component>.schedulerName` | Pod `spec.schedulerName` for all components. See [Scheduler Requirements for NUMA-aware Clusters](/nim/maxine/lipsync-h4m/getting-started#scheduler-requirements-for-numa-aware-clusters). |
| HTTP endpoint Service type | `global.service.type` | `<component>.service.type` | Sets the Kubernetes Service type for each component endpoint (sender, receiver, NIM). Supported values: `ClusterIP`, `NodePort`, `LoadBalancer`. Default is `NodePort`. Use `ClusterIP` for internal access only and `LoadBalancer` for external access. |

<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` | Often `topo-aware-scheduler`; confirm for your chart version. See [Scheduler Requirements for NUMA-aware Clusters](/nim/maxine/lipsync-h4m/getting-started#scheduler-requirements-for-numa-aware-clusters). |
| Container image | `image.repository`, `image.tag` | Published NIM image. |
| Image pull secret | `image.secret` | The `docker-registry` secret name for `nvcr.io`. |
| Container security | `containerSecurityContext.*` | Includes `runAsUser`, `runAsGroup`, `runAsNonRoot`, `allowPrivilegeEscalation`, and capabilities. |

---

## NGC and Model Download

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

---

## Model Cache and Logs PVCs

| Configuration | Helm Key | Comment |
|---------------|----------|---------|
| Model cache PVC | `nimModelCache.*` | Default path: `/opt/nim/.cache`. |
| Server logs PVC | `serverLogs.*` | Default path: `/var/log/lipsync`. |

Subkeys: `enabled`, `size`, `storageClassName`. For configuration examples, see [Advanced Usage](/nim/maxine/lipsync-h4m/advanced-usage#persistent-storage).

---

## NMOS

| Configuration | Helm Key | Environment Variable | Comment |
|---------------|----------|------------------------|---------|
| NMOS discovery mode | `nmos.enabled` | `LIPSYNC_NMOS_ENABLED` | `true` or `false`; `false` requires fixed SMPTE ST 2110 (static mode) only. |
| Advertised hostname | `nmos.hostname` | `LIPSYNC_NMOS_HOSTNAME` | NMOS advertisement. |
| Description | `nmos.description` | `LIPSYNC_NMOS_DESCRIPTION` | NMOS description string. |
| Label | `nmos.label` | `LIPSYNC_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>

---

## See Also

- [Configuration Reference](/nim/maxine/lipsync-h4m/configuration)
- [Pipeline Configuration](/nim/maxine/lipsync-h4m/configuration/pipeline): LipSync tuning, video/audio format, and ST 2110 sessions.
- [Getting Started](/nim/maxine/lipsync-h4m/getting-started): Secret creation and high-speed network setup.