Is this page helpful?

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.

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.
Scheduler	`global.schedulerName`	`<component>.schedulerName`	Pod `spec.schedulerName` for all components. See 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.

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

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.