• Windows: Find a suitable driver here.

• Linux: Install the NVIDIA proprietary driver.

  Troubleshooting Linux →click here←

  If the following error occurs, proceed as follows:

  nvidia-smi has failed because it couldn't communicate with the NVIDIA driver. Make sure that the latest NVIDIA driver is installed and running

  1. Check for existing NVIDIA drivers.

     • Run dpkg -l | grep nvidia to see if any NVIDIA drivers are installed.
     • If it shows some drivers, you might want to uninstall them before proceeding with the clean installation: sudo apt-get --purge remove '*nvidia*'

  2. Update system packages. Make sure your system is up to date with sudo apt update and sudo apt upgrade.

  3. (Optional but recommended:) Add the official NVIDIA PPA to ensure you have access to the latest NVIDIA drivers with sudo add-apt-repository ppa:graphics-drivers/ppa and sudo apt update.

  4. Install the recommended driver. Ubuntu can automatically detect and recommend the right NVIDIA driver for your system with the command ubuntu-drivers devices. This will list the available drivers for your GPU and mark the recommended one.
     To install the recommended NVIDIA driver, use sudo apt install nvidia-driver-<version> (replace <version> with the number of the recommended driver e.g., nvidia-driver-535)

  5. Reboot your system with sudo reboot to apply the changes.

  6. Verify the installation with nvidia-smi. This returns something like this, which shows you the driver version in the top center:

      +-----------------------------------------------------------------------------------------+
      | NVIDIA-SMI 552.22                 Driver Version: 552.22         CUDA Version: 12.4     |
      |-----------------------------------------+------------------------+----------------------+
      | GPU  Name                     TCC/WDDM  | Bus-Id          Disp.A | Volatile Uncorr. ECC |
      | Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |
      |                                         |                        |               MIG M. |
      |=========================================+========================+======================|
      |   0  NVIDIA GeForce RTX 3080 ...  WDDM  |   00000000:01:00.0 Off |                  N/A |
      | N/A   53C    P8              9W /  115W |     257MiB /   8192MiB |      0%      Default |
      |                                         |                        |                  N/A |
      +-----------------------------------------+------------------------+----------------------+
  
      +-----------------------------------------------------------------------------------------+
      | Processes:                                                                              |
      |  GPU   GI   CI        PID   Type   Process name                              GPU Memory |
      |        ID   ID                                                               Usage      |
      |=========================================================================================|
      |    0   N/A  N/A     28420    C+G   ...Programs\Microsoft VS Code\Code.exe      N/A      |
      |    0   N/A  N/A     31888    C+G   ...les\Microsoft OneDrive\OneDrive.exe      N/A      |
      +-----------------------------------------------------------------------------------------+

• WSL: Follow the instructions and troubleshooting for Linux above. If you encounter issues/errors during that process, see the troubleshooting section below:

  Troubleshooting WSL →click here←

  When using Windows Subsystem for Linux, your graphics card might not be recognized. If an error occurs after running the command:

  1. If ubuntu-drivers devices throws the error

     • Command 'ubuntu-drivers' not found: run the command sudo apt install ubuntu-drivers-common.
     • ERROR:root:aplay command not found: run the command sudo apt install alsa-utils.

  2. If sudo apt install nvidia-driver-<version> throws the error E: Unable to locate package nvidia-driver-<version>: run the commands

     sudo apt install software-properties-gtk
     sudo add-apt-repository universe
     sudo add-apt-repository multiverse
     sudo apt update
     sudo apt install nvidia-driver-<version> 

  3. If nvidia-smi throws the error nvidia: command not found: the controller is probably not using the correct interface (sudo lshw -c display should show NVIDIA). To solve this, follow these steps. If a docker: permission denied error occurs: close and re-open WSL.

👉 Check NVIDIA driver installation with: nvidia-smi

• Windows: Download an installer from the CUDA website.
  • ⚠️ To avoid common issues, the installation directory should not contain spaces. If possible, install in C:\cuda. Spaces should not cause issues when running deploy_windows.ps1, but this is not guaranteed.
• Linux: Use sudo apt-get install nvidia-cuda-toolkit, or download an installer.

  • Pick the default installation path. If this is not usr/local/cuda/, create a symlink to that path.

  • Match the version shown in your driver (see top right in nvidia-smi output).

  • When prompted what to install: do not install the driver again, only the CUDA toolkit.

  • Add the CUDA bin and lib64 paths to your PATH and LD_LIBRARY_PATH by adding the following lines at the end of your shell profile file (usually .bashrc for Bash):

    export PATH=/usr/local/cuda/bin:$PATH
    export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH

    Apply the changes with source ~/.bashrc.

👉 Check CUDA installation with: nvcc --version

• Download and install from the Go website.
• The GOPATH environment variable should have been set automatically (note: the folder it points to probably doesn't exist yet).
  Check with go env GOPATH.
  Click here to set GOPATH manually if it does not exist.

  • On Windows: %USERPROFILE%/go is often used, e.g. C:/Users/<name>/go. See this guide if you are unfamiliar with environment variables.

  • On Linux: ~/go is often used. Open or create the ~/.bashrc file and add the following lines.

    export GOPATH=$HOME/go
    export PATH=$PATH:$GOPATH/bin

    After editing the file, apply the changes by running source ~/.bashrc.

👉 Check Go installation with: go version

• Linux: sudo apt-get install gcc
  • ⚠️ each CUDA version has a maximum supported gcc version. This StackOverflow answer lists the maximum supported gcc version for each CUDA version. If necessary, use sudo apt-get install gcc-<min_version> instead, with the appropriate <min_version>.
• Windows:
  • CUDA does not support the gcc compiler on Windows, so download and install Visual Studio with the "Desktop development with C++" workload. After installing, check if the path to cl.exe was added to your PATH environment variable (i.e., check whether where cl.exe returns an appropriate path like C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.29.30133\bin\HostX64\x64). If not, add it manually.
  • To compile Go, on the other hand, gcc is needed. Usually this is included in the Go installation, but if not it can be downloaded and installed from w64devkit.

👉 Check C installation with: gcc --version on Linux and where.exe cl.exe on Windows.

_{^{If you don't have a GitHub profile yet, make one here.}}

• Windows: Download and install.
• Linux: sudo apt install git
• Set up your username in Git and setup an SSH key for your GitHub account.

👉 Check Git installation with: git –-version

• Windows: Download and install.
• Linux: sudo apt-get install gnuplot

👉 Check gnuplot installation with: gnuplot -V