Skip to content

INSTALL.md

Latest commit

 

History

History
152 lines (131 loc) · 7.65 KB

INSTALL.md

File metadata and controls

152 lines (131 loc) · 7.65 KB
Raw

Install Docker

These commands should be run in the terminal on Ubuntu. If these instructions, don't work, run the commands from here or google "install docker ce ubuntu".

  1. Update and make sure curl is installed to download the install script.
sudo apt-get update
sudo apt-get install -y curl
  1. Download and run the Docker install script.
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
  1. Add the current user to the "docker" group, so we can run commands without sudo. (You might need to start a new terminal or reboot your computer for this to take effect).
sudo usermod -aG docker $(whoami)
  1. Test it out! Use the docker run hello-world command to download and run the latest Hello World container from the Docker Hub. The output should look like this:
mpcrpaul@mpcrpaul-MS-7B61:~$ docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
1b930d010525: Pull complete 
Digest: sha256:fc6a51919cfeb2e6763f62b6d9e8815acbf7cd2e476ea353743570610737b752
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

Install CUDA Driver (Required to use GPUs)

Only do this part if you don't already have a CUDA driver installed.

  1. Check if you have a CUDA driver already installed by running nvidia-smi in the terminal. If the command outputs something like this, you can skip the rest of this section.
mpcrpaul@mpcrpaul-MS-7B61:~$ nvidia-smi
Wed Feb 19 21:20:21 2020       
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 418.56       Driver Version: 418.56       CUDA Version: 10.1     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  GeForce GTX 108...  Off  | 00000000:01:00.0  On |                  N/A |
| 23%   36C    P8    18W / 250W |   8819MiB / 11177MiB |      5%      Default |
+-------------------------------+----------------------+----------------------+
|   1  GeForce GTX 108...  Off  | 00000000:03:00.0 Off |                  N/A |
| 23%   28C    P8     8W / 250W |   7589MiB / 11178MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+
                                                                               
+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID   Type   Process name                             Usage      |
|=============================================================================|
|    0      1179      G   /usr/lib/xorg/Xorg                           205MiB |
|    0      2564      G   compiz                                       231MiB |
|    0      3008      G   /usr/lib/firefox/firefox                       2MiB |
|    0      3189      G   /opt/teamviewer/tv_bin/TeamViewer              9MiB |
|    0      5440      G   ...quest-channel-token=7951824858324179070   107MiB |
|    0     10535      G   /usr/lib/firefox/firefox                       2MiB |
|    0     23424      C   /usr/bin/python3                            8251MiB |
|    0     23478      G   /usr/lib/firefox/firefox                       2MiB |
|    1     23424      C   /usr/bin/python3                            7577MiB |
+-----------------------------------------------------------------------------+
  1. Add this 3rd party NVIDIA graphics drivers repository
sudo add-apt-repository ppa:graphics-drivers/ppa
sudo apt-get update
  1. List the available drivers by running ubuntu-drivers devices. Output should look something like this (Note the driver versions):
mpcrpaul@mpcrpaul-MS-7B61:~$ ubuntu-drivers devices
== /sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0 ==
vendor   : NVIDIA Corporation
modalias : pci:v000010DEd00001B06sv000010DEsd0000120Fbc03sc00i00
driver   : nvidia-384 - distro non-free
driver   : nvidia-430 - third-party free recommended
driver   : nvidia-410 - third-party free
driver   : nvidia-415 - third-party free
driver   : nvidia-418 - third-party free
driver   : xserver-xorg-video-nouveau - distro free builtin
  1. Install the graphics driver version you want (i.e. nvidia-418). Try the most recent one if you're not sure, and downgrade if that breaks anything. Compatibility between driver versions and CUDA Toolkit versions can be found in this table.
sudo apt-get install nvidia-[VERSION]
  1. Restart your computer, and nvidia-smi should work.
sudo reboot

Install Nvidia-Docker (Required to use GPUs)

If these instructions don't work, follow along here.

  1. Add the Nvidia-Docker repository
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update
  1. Install the Nvidia-Docker runtime
sudo apt-get install -y nvidia-container-toolkit
  1. Restart the docker daemon so it will see the new runtime.
sudo systemctl restart docker
  1. Test it out! The following command will download a container from NVIDIA's Docker Hub account which contains version 9.0 of the CUDA Toolkit. The nvidia-smi command will be run from inside the container, and we will see the same output as we would on the host. the --gpus all flag tells docker to use the Nvidia-Docker runtime.
docker run --gpus all nvidia/cuda:9.0-base nvidia-smi

You should see something like this output:

mpcrpaul@mpcrpaul-MS-7B61:~$ docker run --gpus all nvidia/cuda:9.0-base nvidia-smi
Thu Feb 20 04:09:27 2020       
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 418.56       Driver Version: 418.56       CUDA Version: 10.1     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  GeForce GTX 108...  Off  | 00000000:01:00.0  On |                  N/A |
| 23%   38C    P8    19W / 250W |   8824MiB / 11177MiB |      3%      Default |
+-------------------------------+----------------------+----------------------+
|   1  GeForce GTX 108...  Off  | 00000000:03:00.0 Off |                  N/A |
| 23%   28C    P8     8W / 250W |   7589MiB / 11178MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+
                                                                               
+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID   Type   Process name                             Usage      |
|=============================================================================|
+-----------------------------------------------------------------------------+