Improve Docker GPU setup diagnostics (#705)

* Improve Docker GPU setup diagnostics

Add a Docker GPU preflight script for NVIDIA users. The script is
read-only by default, checks host NVIDIA drivers, Docker availability,
and container GPU passthrough, and prints actionable next steps.

Add explicit opt-in modes to print install commands, install NVIDIA
Container Toolkit on Ubuntu/Debian, and enable the NVIDIA Compose overlay
in .env after passthrough is verified.

Document common NVIDIA Docker failure modes, ignore generated .env
backups, and clarify that Cookbook can only detect GPUs exposed to the
Odysseus container.

* Clarify Docker GPU diagnostic limits
This commit is contained in:
Alexandre Teixeira
2026-06-02 04:30:40 +01:00
committed by GitHub
parent 517aa593e0
commit 8455b88643
5 changed files with 635 additions and 5 deletions

1
.gitignore vendored
View File

@@ -12,6 +12,7 @@ venv/
# Environment
.env
.env.bak.*
!.env.example
# Data — all user data stays local