[PR #467] docs: document NVIDIA CDI setup for modern drivers #485

New issue

Open

opened 2026-10-15 13:00:56 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 13:00:56 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/games-on-whales/wolf/pull/467
Author: @Finkregh
Created: 7/27/2026
Status: 🔄 Open

Base: beta ← Head: docs/nvidia-modern-cdi-setup

📝 Commits (1)

65f866b docs: document NVIDIA CDI setup for modern drivers

📊 Changes

2 files changed (+200 additions, -0 deletions)

View changed files

📝 README.md (+24 -0)
📝 docs/modules/user/pages/quickstart.adoc (+176 -0)

📄 Description

Add a new Nvidia (CDI, modern drivers) tab to the quickstart guide with matching docker run and docker-compose examples, plus a short pointer in the README.

Documents a setup which works on recent NVIDIA drivers + NVIDIA Container Toolkit + docker and calls out — as inline comments — the differences vs. the previous variant:

GPU is passed via CDI (nvidia.com/gpu=all) rather than --gpus=all / deploy.resources.reservations.devices block.
__EGL_VENDOR_LIBRARY_FILENAMES is set so libglvnd inside the container enumerates both the NVIDIA and image-baked Mesa ICDs (needed on NixOS-style hosts where the ICD JSON lives under /run/opengl-driver/...).
A follow-up TIP explains that each [profiles.apps.runner] in config.toml must also set DeviceRequests in base_create_json and mirror the env vars, otherwise child containers hit the same auto-injection failure.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/games-on-whales/wolf/pull/467 **Author:** [@Finkregh](https://github.com/Finkregh) **Created:** 7/27/2026 **Status:** 🔄 Open **Base:** `beta` ← **Head:** `docs/nvidia-modern-cdi-setup` --- ### 📝 Commits (1) - [`65f866b`](https://github.com/games-on-whales/wolf/commit/65f866bbd81b9bb97f2e2e3e96f3e7a981f268ce) docs: document NVIDIA CDI setup for modern drivers ### 📊 Changes **2 files changed** (+200 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+24 -0) 📝 `docs/modules/user/pages/quickstart.adoc` (+176 -0) </details> ### 📄 Description Add a new `Nvidia (CDI, modern drivers)` tab to the quickstart guide with matching `docker run` and `docker-compose` examples, plus a short pointer in the README. Documents a setup which works on recent NVIDIA drivers + NVIDIA Container Toolkit + docker and calls out — as inline comments — the differences vs. the previous variant: - GPU is passed via CDI (`nvidia.com/gpu=all`) rather than `--gpus=all` / `deploy.resources.reservations.devices` block. - `__EGL_VENDOR_LIBRARY_FILENAMES` is set so libglvnd inside the container enumerates both the NVIDIA and image-baked Mesa ICDs (needed on NixOS-style hosts where the ICD JSON lives under /run/opengl-driver/...). - A follow-up TIP explains that each `[profiles.apps.runner]` in `config.toml` must also set `DeviceRequests` in `base_create_json` and mirror the env vars, otherwise child containers hit the same auto-injection failure. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

2026-10-15 13:00:56 +00:00

bsakaguchi referenced this issue

2026-10-15 13:00:59 +00:00

[PR #485] Update endpoints.cpp to randomly generate the client_cert instead of app_state_folder #492