Install NPU Operator
Use this page to install the NPU Operator and create the NPUOperatorCtl resource. Choose one scenario, prepare only its prerequisites, apply the matching CR, and then verify the resulting NPU stack.
TOC
Installation path1. Upload and install packages2. Choose a scenario and create the CROperator-managed physical hostOperator-managed immutable OSDriver managed outside NPU OperatorNPU Operator with HAMi3. Verify the installationInstallation path
Follow the steps in order:
- Read Prerequisites and choose a Driver scenario.
- Upload the NPU Operator package and required shared packages.
- Install Node Feature Discovery and NPU Operator.
- Apply the minimum CR for the selected scenario below.
- Continue with Verify the installation.
1. Upload and install packages
Upload Alauda Build of NPU Operator from Customer Portal. Install Alauda Build of Node Feature Discovery on the target workload cluster before creating the NPUOperatorCtl resource. Install Volcano only when you have a separate plan to enable ClusterD.
For package upload, use Upload Packages. For NFD installation, use the shared NFD documentation.
Install the NPU Operator from Administrator > Marketplace > OperatorHub, switch to the target workload cluster, and wait for its Subscription and CSV to become ready. Installing the Operator starts the controller; it does not yet deploy the Driver, runtime, or Device Plugin.
2. Choose a scenario and create the CR
The examples below use only fields supported by the Alauda v26.6.0 CRD. They use the automatic runtime path: Device Plugin enabled, Ascend runtime enabled, ascend RuntimeClass, and webhook enabled. The workload image still provides CANN and the application framework.
Operator-managed physical host
Use this when the physical OS can run the delivered Host Driver installer. Prepare the host according to Prerequisites, then apply:
Operator-managed immutable OS
Use this when the node uses an immutable OS and a matching precompiled Driver image. Complete Driver image preparation before applying:
Driver managed outside NPU Operator
Use this when another system installs and upgrades a healthy Host Driver on every selected node:
Apply the selected file:
Do not switch an existing installation between host and containerized by editing only driver.installMode. Follow Driver mode change is refused for an approved migration.
NPU Operator with HAMi
Keep the Driver, OCI Runtime, ascend RuntimeClass, and webhook enabled. After the NPU Operator base is ready, disable the NPU Operator Device Plugin for the complete ownership scope and follow Choose an Ascend NPU Allocation Mode to install HAMi's Ascend Device Plugin. Use one RuntimeClass injector for each workload: the NPU Operator webhook is the recommended default; a default HAMi install does not inject ascend unless its Ascend device configuration explicitly sets it.
3. Verify the installation
Continue with Verify the installation. Do not accept the installation based only on Pod Running, a device node, or npu-smi info; complete the ACL and application checks on that page.