Skip to content

Commit 6b38649

Browse files
committed
Adding CUDA version documentation
1 parent 2851c38 commit 6b38649

File tree

3 files changed

+27
-0
lines changed

3 files changed

+27
-0
lines changed

docs.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,7 @@
206206
{
207207
"group": "Troubleshooting",
208208
"pages": [
209+
"references/troubleshooting/cuda-version-issue",
209210
"references/troubleshooting/leaked-api-keys",
210211
"references/troubleshooting/storage-full",
211212
"references/troubleshooting/troubleshooting-502-errors",
87.7 KB
Loading
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: "CUDA version mismatch"
3+
---
4+
5+
When using RunPod templates or community templates, such as "runpod/pytorch:2.8.0-py3.11-cuda12.8.1-cudnn-devel-ubuntu22.04", you might occasionally encounter errors such as:
6+
7+
```bash
8+
RunPod Pytorch 2.8.0 runpod/pytorch:2.8.0-py3.11-cuda12.8.1-cudnn-devel-ubuntu22.04 start container for runpod/pytorch:2.8.0-py3.11-cuda12.8.1-cudnn-devel-ubuntu22.04: begin error starting container: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error running prestart hook #0: exit status 1, stdout: , stderr: Auto-detected mode as 'legacy' nvidia-container-cli: requirement error: unsatisfied condition: cuda>=12.8, please update your driver to a newer version, or use an earlier cuda container: unknown
9+
```
10+
11+
This error occurs when there's a mismatch between the CUDA version required by your container template and the CUDA driver version installed on the host machine. In this example, the template requires CUDA 12.8 or higher, but the host machine has an older CUDA driver installed.
12+
13+
## Resolution
14+
15+
To resolve this issue when launching a Pod:
16+
1. Click "Additional filters" in the Pod creation interface
17+
2. Click "CUDA Versions" filter dropdown
18+
3. Select a CUDA version filter that matches or exceeds your template's CUDA requirements
19+
20+
<Frame>
21+
<img src="/images/additional-filter-cuda-version.png" />
22+
</Frame>
23+
24+
In this example, the RunPod template name includes `cuda12.8.1`, indicating it requires CUDA 12.8 or higher. You should select a CUDA version filter of at least 12.8.
25+
26+
**Note:** If you're unsure about your template's CUDA requirements (especially for community templates), check the template documentation or error message. You can also just choose the latest CUDA drivers as they are backward compatible - newer drivers can run containers with older CUDA versions installed.

0 commit comments

Comments
 (0)