Salastil/odysseus
1
0
Fork 0
mirror of https://github.com/pewdiepie-archdaemon/odysseus.git synced 2026-08-07 14:08:43 -04:00
Code Issues Packages Projects Releases Wiki Activity

docs(docker): polish WSL2 snap GPU guidance

Browse Source
This commit is contained in:
RaresKeY
2026-07-08 19:30:41 +00:00
parent db1170e63a
commit 109301be78
2 changed files with 31 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/setup.md
+27 -14
View File
@@ -151,20 +151,33 @@ scripts/check-docker-gpu.sh --enable-nvidia-overlay
scripts/check-docker-gpu.sh --install-nvidia-toolkit --enable-nvidia-overlay
```
> **WSL2 + snap Docker.** If `docker run --gpus all ...` fails with
> `failed to fulfil mount request: open /usr/lib/wsl/lib/libdxcore.so: no
> such file or directory`, check whether Docker was installed via `snap`
> (`snap list docker`, or `docker info --format '{{.DockerRootDir}}'` reports
> a path under `/var/snap/docker/`). Snap's confinement prevents Docker from
> seeing the GPU library WSL2 injects at `/usr/lib/wsl/lib`, even though the
> file exists on the host — installing or reconfiguring
> `nvidia-container-toolkit` will not fix this, since the toolkit isn't the
> problem. `scripts/check-docker-gpu.sh` detects this combination and calls
> it out directly. The fix is to remove snap Docker and install the official
> apt-based Docker Engine instead
> ([docs.docker.com/engine/install](https://docs.docker.com/engine/install/)),
> then re-run `nvidia-ctk runtime configure --runtime=docker` and restart
> Docker.
**WSL2 + snap Docker.** If the NVIDIA check fails with this error, Docker may be
installed via snap:
```text
failed to fulfil mount request: open /usr/lib/wsl/lib/libdxcore.so: no such file or directory
```
Check with `snap list docker` or:
```bash
docker info --format '{{.DockerRootDir}}'
```
A Docker root under `/var/snap/docker/` means snap confinement can prevent
Docker from seeing WSL2's `/usr/lib/wsl/lib` GPU libraries even when the files
exist on the host. Reinstalling or reconfiguring `nvidia-container-toolkit` will
not fix that. Remove snap Docker, install the official apt-based Docker Engine
([Docker docs](https://docs.docker.com/engine/install/ubuntu/)), then configure
the NVIDIA runtime again:
```bash
sudo snap remove docker
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
```
Then re-run `scripts/check-docker-gpu.sh`.
Safety notes:
- The app never installs host GPU runtime automatically.