Skip to content

feature: GPU node and Proxmox LXC check scripts - #702

Open
Flegma wants to merge 1 commit into
mainfrom
feature/gpu-node-check-scripts
Open

Flegma wants to merge 1 commit into
mainfrom
feature/gpu-node-check-scripts

Conversation

@Flegma

@Flegma Flegma commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

Adds two check scripts for GPU nodes, next to setup-gpu-nodes.sh (#700):

  • gpu-node/gpu-node-check.sh runs on the GPU node. It checks the driver, firmware, container runtime (NVIDIA toolkit), CPU governor, free disk and the k3s version against the panel's, and says when an AMD GPU is integrated so it goes in the integrated list.
  • gpu-node/proxmox-gpu-lxc.sh CTID runs on a Proxmox host. It checks the host driver and kernel modules k3s needs, and the container's settings (privileged, nesting, device entries for /dev/dri + /dev/kfd or the NVIDIA devices, cgroup and mounts).
  • gpu-node/README.md walks through a dedicated machine or VM and a Proxmox LXC container, for NVIDIA and AMD, one vendor per panel as setup-gpu-nodes.sh sets it up.

Both scripts only report unless --apply is passed, exit 1 while something still fails, and never touch GPU power or clock settings.

Testing

  • tests/scripts/proxmox_gpu_lxc_test.sh (9 tests, added to the Panel scripts workflow), gpu_nodes_test.sh and shellcheck pass.
  • The checks follow how our NVIDIA node (Ubuntu, dedicated machine) and AMD node (Ryzen AI Max APU in a privileged Proxmox LXC container) are set up.
  • --apply of both scripts is not yet tested on real hardware (a Proxmox host or a fresh node). The config lines proxmox-gpu-lxc.sh --apply writes are the ones our AMD container runs with, but the write path itself has only run in the test. Please treat --apply as a first version.

gpu-node/gpu-node-check.sh checks a GPU node (driver, firmware, container
runtime, CPU governor, disk, k3s version) and gpu-node/proxmox-gpu-lxc.sh checks
a Proxmox host and its LXC container. Both only report unless --apply is given.
The README walks through dedicated machines, VMs and Proxmox LXC containers for
NVIDIA and AMD, one vendor per panel as setup-gpu-nodes.sh sets it up.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant