Installation prerequisites¶

Setting up your environment

This page provides important prerequisites to complete prior to installing the LEIP Onsite SDK. In summary, the supported environment consists of Ubuntu running Docker with access to a CUDA-enabled GPU.

Install Ubuntu¶

Ubuntu 20.04 or 22.04

The LEIP Onsite SDK supports Ubuntu 20.04 or 22.04.

Consult the Ubuntu installation tutorial for step-by-step instructions on installing Ubuntu.

Install third-party software for graphics and Wi-Fi hardware

When asked if you'd like to install recommended proprietary software, ensure this box is checked to install necessary NVIDIA drivers.

Install NVIDIA drivers¶

Update your package index files. On Ubuntu, run the following:
```
sudo apt update
```
Install CUDA Toolkit: Select your Operating System, Architecture, Distribution, and Version. For Installer Type, select "deb (network)."
To verify successful installation, run the following:
```
nvidia-smi
```
This command should return a summary of the current state of all NVIDIA GPUs installed on your machine.

Install Docker¶

To install Docker on Ubuntu, follow the instructions for installing Docker using apt.

Manage Docker as a non-root user

If you cannot use Docker without sudo privileges, follow the instructions for managing Docker as a non-root user and restart your computer.

Enable GPU usage in Docker¶

Follow NVIDIA's instructions for installing nvidia-container-toolkit with apt.
Follow NVIDIA's instructions for configuring Docker.
You can verify GPU usage in Docker with the following command, which should return GPU performance benchmark results:
```
docker run --gpus all nvcr.io/nvidia/k8s/cuda-sample:nbody nbody -gpu -benchmark
```