|
| 1 | +# NVIDIA CUDA (nvidia-cuda) |
| 2 | + |
| 3 | +A package which installs NVIDIA CUDA. |
| 4 | + |
| 5 | +## Example Usage |
| 6 | + |
| 7 | +```json |
| 8 | +"features": { |
| 9 | + "ghcr.io/postfinance/devcontainer-features/nvidia-cuda:0.1.0": { |
| 10 | + "version": "latest", |
| 11 | + "installLibraries": true, |
| 12 | + "installDevLibraries": true, |
| 13 | + "installCompiler": true, |
| 14 | + "installTools": true, |
| 15 | + "additionalCudaPackages": "", |
| 16 | + "downloadUrl": "" |
| 17 | + } |
| 18 | +} |
| 19 | +``` |
| 20 | + |
| 21 | +## Options |
| 22 | + |
| 23 | +| Option | Description | Type | Default Value | Proposals | |
| 24 | +|-----|-----|-----|-----|-----| |
| 25 | +| version | The version of NVIDIA CUDA to install. | string | latest | latest, 12.3, 12.9 | |
| 26 | +| installLibraries | Installs all runtime CUDA Library packages. | boolean | true | true, false | |
| 27 | +| installDevLibraries | Installs all development CUDA Library packages. | boolean | true | true, false | |
| 28 | +| installCompiler | Installs all CUDA compiler packages. | boolean | true | true, false | |
| 29 | +| installTools | Installs all CUDA command line and visual tools. | boolean | true | true, false | |
| 30 | +| additionalCudaPackages | A comma-separated list of additional CUDA packages to install. Disable the other flags to have full control over what is installed. | string | <empty> | | |
| 31 | +| downloadUrl | The download URL to use for CUDA binaries. | string | <empty> | https://mycompany.com/artifactory/nvidia-cuda-generic-remote/ | |
| 32 | + |
| 33 | +## Notes |
| 34 | + |
| 35 | +### System Compatibility |
| 36 | + |
| 37 | +> Only amd64 is supported |
| 38 | +
|
| 39 | +Debian, Ubuntu |
| 40 | + |
| 41 | +### Accessed Urls |
| 42 | + |
| 43 | +Needs access to the following URL for downloading and resolving: |
| 44 | +* https://developer.download.nvidia.com |
| 45 | + |
| 46 | +### Install the NVIDIA Container Toolkit |
| 47 | + |
| 48 | +Follow [NVIDIA's instructions to install the NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/overview.html) on your host machine. The NVIDIA Container Toolkit is available on a variety of Linux distributions. Make sure you have [installed the NVIDIA driver](https://docs.nvidia.com/datacenter/tesla/driver-installation-guide/index.html) for your Linux distribution before installing the NVIDIA Container Toolkit. |
| 49 | + |
| 50 | +### Package Dependency Tree |
| 51 | + |
| 52 | +Here is a list of the dependency tree of the packages in case you want to install only some of them. |
| 53 | + |
| 54 | +cuda-toolkit |
| 55 | +- cuda-compiler |
| 56 | + - cuda-cuobjdump |
| 57 | + - cuda-cuxxfilt |
| 58 | + - cuda-nvcc |
| 59 | + - cuda-nvprune |
| 60 | +- cuda-libraries |
| 61 | + - libnpp |
| 62 | +- cuda-libraries-dev |
| 63 | +- cuda-tools |
| 64 | + - cuda-command-line-tools |
| 65 | + - cuda-nvtx |
| 66 | + - cuda-visual-tools |
| 67 | + - gds-tools |
| 68 | +- cuda-documentation |
| 69 | +- cuda-nvml-dev |
| 70 | + |
| 71 | +### NVIDIA cuDNN |
| 72 | + |
| 73 | +TODO: This is not yet supported |
| 74 | + |
| 75 | +* libcudnn8 - cuDNN runtime libraries |
| 76 | +* libcudnn8-dev - cuDNN development libraries and headers |
| 77 | +* libcudnn9-cuda-11 - cuDNN runtime libraries for CUDA 11.8 |
| 78 | +* libcudnn9-dev-cuda-11 - cuDNN development headers and symlinks for CUDA 11.8 |
| 79 | +* libcudnn9-cuda-12 - cuDNN runtime libraries for CUDA 12.4 |
| 80 | +* libcudnn9-dev-cuda-12 - cuDNN development headers and symlinks for CUDA 12.4 |
0 commit comments