Skip to main content
Version: v5.0 Stable

Certified Stacks

Certified Stacks are first-party integrations built from tested StackTemplates and supporting resources bundled with vCluster Platform. They package multi-application integrations that need dependency ordering, health gates, and shared configuration.

Bundled StackTemplates carry the certified marker and are read-only in the platform UI. They use the same StackTemplate and StackInstance APIs as custom Stacks.

Understand the certified catalog​

Platform v5.0 bundles NVIDIA Run:ai, NVIDIA Dynamo, Saturn Cloud Enterprise, and the NVIDIA NVKE management plane as certified integrations. Together they contain seven StackTemplates, five VirtualClusterTemplates, and the Apps those templates reference.

IntegrationDeployment modelsComponents
NVIDIA Run:aiDedicated control plane and central control planevCluster, NVIDIA GPU components, and NVIDIA Run:ai 2.26
NVIDIA DynamoOne runtime per cluster or control plane clusterNVIDIA Dynamo operator, NATS, and etcd
Saturn Cloud EnterpriseOne installation per cluster or control plane clusterSaturn Cloud Helm operator, which installs the Saturn Cloud Enterprise components
NVIDIA NVKE management planeOne installation per cluster, on private nodes or shared nodescert-manager, PostgreSQL, Temporal, SPIRE, the NVKE telemetry pipeline, and the NVKE controller, installed from an NVKE release that you build with NVKR

Each Platform release pins one release of the upstream vcluster-stacks repository. Platform v5.0 bundles v1.2.0. The repository's certified-stacks directory contains the source manifests, tests, and full implementation guide for each integration. The same repository also hosts Community Stacks from customers, partners, and the community. Platform doesn't bundle them.

Platform records which revision of the bundle it applied. When an upgrade ships a newer revision, Platform applies the certified objects again and creates the ones that are new. Fields the bundle sets return to their bundled values, but fields you added that the bundle doesn't set are kept. Certified objects that a later bundle drops aren't deleted. Platform skips any certified object annotated with loft.sh/skip-update: "true", which also means it stops receiving fixes.

Use a certified stack​

Choose a deployment model on the integration page. Then use the administrator guide to validate prerequisites and follow the supported lifecycle:

Certified Stack orchestration doesn't have a separate license feature. Each task uses the feature for the resource it creates. Every bundled template contains only App tasks, and Apps are available on every plan. Platform installs the bundle only when the license includes the Apps feature. The bundled VirtualClusterTemplates also need a license feature for cluster management or for the security-hardened vCluster image.

Customize a certified stack​

Certified StackTemplates are read-only in the platform UI. The management API doesn't block edits, but the next bundle revision resets every field the bundle sets. To change one, create your own StackTemplate from the certified stack's YAML. Give it a different name, and remove the vcluster.com/certified annotation. Your template is a separate resource and doesn't receive changes from later certified bundles.

Keep the bundled object unchanged so its source and support status remain clear. Review task dependencies, fixed names, chart versions, and output namespaces together when modifying your template.

For the steps, see Customize a certified stack.

Explore the broader NVIDIA integration​

Start with NVIDIA DSX OS for the included NICo driver, GPU health templates, and application Stacks. The NVKE management-plane guide covers the bundled integration and a source fallback for builds without it. NVKE is an upstream preview intended for evaluation.

Understand the previous workflow​

Earlier Certified Stacks are repository-based reference implementations. They can include Terraform, Helm, and other orchestration outside the Stack API. Those implementations remain available on the certified-stacks-legacy branch of the vcluster-stacks repository for users who rely on them.

The native bundle, introduced in Platform v4.12, is a separate delivery model. It seeds StackTemplates directly into Platform and lets users install StackInstances through the UI or management API.