Skip to content

Cluster Install

Below are instructions on how to install a Run:ai cluster.


Before installing, please review the installation prerequisites here: Run:ai GPU Cluster Prerequisites.


We strongly recommend running the Run:ai pre-install script to verify that all prerequisites are met.

Install Run:ai

Log in to Run:ai user interface at <company-name> Use credentials provided by Run:ai Customer Support:

  • If no clusters are currently configured, you will see a Cluster installation wizard.
  • If a cluster has already been configured, use the menu on the top left and select Clusters. On the top left, click New Cluster.

Using the cluster wizard:

  • Choose a name for your cluster.
  • Choose the Run:ai version for the cluster.
  • Choose a target Kubernetes distribution (see table for supported distributions).
  • (SaaS and remote self-hosted cluster only) Enter a URL for the Kubernetes cluster. The URL need only be accessible within the organization's network. For more informtaion see here.
  • Press Continue.

On the next page:

  • (SaaS and remote self-hosted cluster only) Install a trusted certificate to the domain entered above.
  • Run the Helm command provided in the wizard.

Verify your Installation

  • Go to <company-name>
  • Verify that the number of GPUs on the top right reflects your GPU resources on your cluster and the list of machines with GPU resources appears on the bottom line.
  • Run: kubectl get cm runai-public -n runai -o jsonpath='{.data}' | yq -P

(assumes that yq is instaled)

Example output:

cluster-version: 2.9.0
  version: 2.9.0
  runaiConfigStatus: # (1)
    - type: DependenciesFulfilled
      status: "True"
      reason: dependencies_fulfilled
      message: Dependencies are fulfilled
    - type: Deployed
      status: "True"
      reason: deployed
      message: Resources Deployed
    - type: Available
      status: "True"
      reason: available
      message: System Available
    - type: Reconciled
      status: "True"
      reason: reconciled
      message: Reconciliation completed successfully
  optional:  # (2)
    knative:    # (3)  
          available: true
          available: true
          available: true
    mpi:        # (4) 
      available: true
  1. Verifies that all mandatory dependencies are met: NVIDIA GPU Operator, Prometheus and NGINX controller.
  2. Checks whether optional product dependencies have been met.
  3. See Inference prerequisites.
  4. See distributed training prerequisites.

For a more extensive verification of cluster health, see Determining the health of a cluster.

Researcher Authentication

If you will be using the Run:ai command-line interface or sending YAMLs directly to Kubernetes, you must now set up Researcher Access Control.

Customize your installation

To customize specific aspects of the cluster installation see customize cluster installation.

(Optional) Set Node Roles

When installing a production cluster you may want to:

  • Set one or more Run:ai system nodes. These are nodes dedicated to Run:ai software.
  • Machine learning frequently requires jobs that require CPU but not GPU. You may want to direct these jobs to dedicated nodes that do not have GPUs, so as not to overload these machines.
  • Limit Run:ai to specific nodes in the cluster.

To perform these tasks. See Set Node Roles.

Next Steps