README

NVIDIA Kubernetes Engine (NVKE)




Run a managed Kubernetes service on your own NVIDIA GPU infrastructure.
NVIDIA Kubernetes® Engine (NVKE) provides the management plane that platform teams install to create and
operate Kubernetes clusters for their customers. Each workload cluster has its
own Kubernetes control plane, etcd and node pools. You operate the NVKE management
plane; your customers use their clusters through the Kubernetes API and kubectl.

 Preview: NVKE is available as a preview. APIs, configuration and behavior
 can change between releases, and we do not recommend NVKE for production
 workloads. See Preview status and known limitations.

Get started · Documentation ·
Contribute · Get help

 Getting started

| Your goal | Start here | What you get |
|---|---|---|
| Evaluate without GPU hardware | Local quickstart | A development management plane and a workload cluster on simulated machines. No NVIDIA account is required. |
| Install on your infrastructure | Plan your installation | The prerequisites and sequence for preparing nodes, bootstrapping a management cluster and installing its services. |
| Build or contribute | Build from source | The NVKE binaries and the contributor development loop. |

The local quickstart runs on a Linux host or VM, amd64 or arm64, with at least
6 CPUs, 12 GiB of free memory and 100 GiB of free disk. It requires Docker,
virtual TPM support and the tools listed in the guide. Follow its setup through
workload-cluster creation and confirm the cluster's nodes report Ready.
On macOS, use the local site guide, which runs
the evaluation inside a Colima virtual machine.

For a real installation, you supply the machines, networking, node images and
registries, and configure access to NVIDIA Infra Controller (NICo). NICo is
the sole compatible infrastructure provider at preview. The
platform and version reference lists
validated combinations and pinned dependencies.

 What NVKE does

- Creates independent workload clusters. Request clusters through the NVKE
  API or nvkectl; NVKE provisions machines through NICo and forms Kubernetes
  clusters with their own control planes.
- Manages workload cluster lifecycle. Create, scale and delete node pools,
  upgrade Kubernetes and replace nodes. See the node pool guide
  for the manual steps and preview limits on replacement and upgrades.
- Establishes node identity. Nodes attest through SPIFFE/SPIRE using their
  TPM before receiving join credentials. Encryption of etcd data is available
  per cluster.
- Connects builds to deployment. Its companion project,
  NVIDIA Kubernetes Recipes (NVKR),
  builds node images and NVKE components from pinned inputs. NVKE deploys those
  artifacts; NVKR owns their build and release evidence.

The preview needs explicit operator configuration: API authentication is off
and the API uses plain HTTP after installation. Configure
API authentication and protected access
before admitting callers. The management cluster does not upgrade, scal

Top issues

Latest release

Changelog


 Bug Fixes


 347baabc64ba320176c6c2ef956e555350124d19: fix(controller): parse tenant kubeconfigs with an allowlist (release-0.23 backport) (2103) (@danbudris)


 Appendix A: Controller and Bootstrap Dependencies


 Images


| Image | Chart | Version | Digest | Source |
| --- | --- | --- | --- | --- |
| server | temporal | 1.30.3 | sha256:a3d0f727caad0ecca5dc6e94766135aab448551f2c6c0d33d3c67576458e6a0d | Source |
| admin-tools | temporal | 1.30.3 | sha256:2c2272b008f1af295b3719963e6feeef64f838d1105d895cf6acfcf96dd31741 | Source |
| ui | temporal | 2.48.1 | sha256