Skip to content

Cluster Install

The following are instructions on how to install Run:AI on the customer's Kubernetes Cluster. Before installation please review the installation prerequisites here: Run AI GPU Cluster Prerequisites.

Step 1: NVIDIA

On each machine with GPUs run the following steps 1.1 - 1.3:

Step 1.1 Install NVIDIA Drivers

If NVIDIA drivers are not already installed on your GPU machines, please install them now. Note that on original NVIDIA hardware, these drivers are already installed by default. After installing NVIDIA drivers, reboot the machine. Then verify that the installation succeeded by running:


Step 1.2: Install NVIDIA Docker

This step assumes that Docker is already installed on the machine. If not, please install using

To install NVIDIA Docker on Debian-based distributions (such as Ubuntu), run the following:

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L | sudo apt-key add -
curl -s -L$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update && sudo apt-get install -y nvidia-docker2
sudo pkill -SIGHUP dockerd

For RHEL-based distributions, see nvidia-docker installation instructions, or run:

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L$distribution/nvidia-docker.repo | sudo tee /etc/yum.repos.d/nvidia-docker.repo
sudo yum install -y nvidia-docker2
sudo pkill -SIGHUP dockerd

Step 1.3: Make NVIDIA Docker the default docker runtime

You will need to enable the Nvidia runtime as your default docker runtime on your node. Edit the docker daemon config file at /etc/docker/daemon.json and add the default-runtime key as follows:

    "default-runtime": "nvidia",
    "runtimes": {
        "nvidia": {
            "path": "/usr/bin/nvidia-container-runtime",
            "runtimeArgs": []

Then run the following again:

sudo pkill -SIGHUP dockerd

Step 2: Install & Configure Kubernetes

Step 2.1 Install Kubernetes

Installing Kubernetes is beyond the scope of this guide. There are plenty of good ways to install Kubernetes (listed here: We recommend Kubespray . Download the latest stable version from :

Note: Run:AI is customizing the NVIDIA Kubernetes device plugin ( Do not install this software as it is installed by Run:AI.

Some best practices on Kubernetes Configuration can be found here: Kubernetes Cluster Configuration Best Practices.

The following next steps assume that you have the Kubernetes command-line kubectl on your laptop and that it is configured to point to the Kubernetes cluster.

Step 2.2 Default Storage Class

Find out if you have a default storage class by running

kubectl get storageclass

If the output list contains a default storage class you must, in step 3.2 below, remove the Run:AI default storage class.

Step 2.3 Label CPU-Only Worker Nodes

If you have CPU-only worker nodes (non-master) in your cluster (see Hardware Requirements), you will need to label them. Labels help Run:AI to place its software correctly, by avoiding placement of Run:AI containers on GPU nodes used for processing data science and by placing monitoring software on the GPU nodes. To get the list of nodes, run:

kubectl get nodes

To label CPU-only nodes, run the following on each CPU-only node:

kubectl label node <node-name>

Where <node-name> is the name of the node. Node names can be obtained by running kubectl get nodes


Kubernetes master node(s) typically have a "NoSchedule" taint so as to avoid non-system pods running on a master node. Pressuring master nodes may lead to the Kubernetes system not functioning properly. If your master node is not a GPU node, make sure that this taint exists so that Run:AI too, does not run on a master node.

Step 3: Install Run:AI

Step 3.1: Install Run:AI

  • Log in to Run:AI Admin UI at Use credentials provided by Run:AI Customer Support to log in to the system.
  • If this is the first time anyone from your company has logged in, you will receive a dialog with instructions on how to install Run:AI on your Kubernetes Cluster.
  • If not, open the menu on the top left and select "Clusters". On the top right-click "Add New Cluster". Continue according to UI instructions to install Run:AI on your Kubernetes Cluster. Take care to read the next section (Customize Installation) before proceeding to apply the file you download during the process.

Step 3.2: Customize Installation

The Run:AI Admin UI cluster creation wizard asks you to download a YAML file runai-operator-<cluster-name>.yaml. You must then apply the file to Kubernetes. Before applying to Kubernetes, you may need to edit this file. Examples:

Step 4: Verify your Installation

  • Go to
  • Go to the Overview Dashboard.
  • 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 appear on the bottom line.

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

Next Steps

Last update: September 15, 2020