Skip to content

gpu / hwaccell: type GPUs by PCI ID and install the right NVIDIA packages on Ubuntu - #247

Merged
michelroegl-brunner merged 2 commits into
mainfrom
fix/hwaccel-gpu-ids-ubuntu-nvidia
Nov 13, 2026
Merged

michelroegl-brunner merged 2 commits into
mainfrom
fix/hwaccel-gpu-ids-ubuntu-nvidia

Conversation

@MickLesk

Copy link
Copy Markdown
Member

✍️ Description

GPU vendors come from the PCI vendor ID, and Intel's discrete cards (DG1, Alchemist, Battlemage) from the device ID. Names depend on the pci.ids at hand: a Battlemage card was "Device e212" on Ubuntu 24.04 and took the Gen9+ path.

On Ubuntu the NVIDIA branch asked for libcuda1, which does not exist there, and then for libnvidia-decode-, which NVIDIA stopped publishing with 590. It now picks libnvidia-compute with or without the series in its name, whichever has the host's release, pins that version and installs with the same flags as Debian. The version pin also covers nvidia-*, since libnvidia-compute needs nvidia-persistenced at exactly its own version.

🔗 Related Issue

Fixes #

✅ Prerequisites (X in brackets)

  • Self-review completed – Code follows project standards.
  • Tested thoroughly – Changes work as expected (Proxmox VE and/or Incus, as applicable).
  • No security risks – No hardcoded secrets, unnecessary privilege escalations, or permission issues.
  • API.txt regenerated – If a function signature or behavior changed, API.txt was updated to match.

🛠️ Type of Change (X in brackets)

  • 🐞 Bug fix – Resolves an issue without breaking functionality.
  • ✨ New feature – Adds new, non-breaking functionality.
  • 💥 Breaking change – Alters existing behavior in a way that may require updates in every downstream script.
  • 🔧 Refactoring / Code Cleanup – Improves readability or maintainability without changing functionality.
  • 📝 Documentation update – Changes to README, docs/, CONTRIBUTING.md, or other docs.

🤖 AI Assistance (X in brackets)

If you used an AI tool (GitHub Copilot, Claude, ChatGPT, etc.) to write or generate any code in this PR, you must confirm compliance below.
Select exactly one option.

  • No AI used – Code was written without AI assistance.
  • AI was used – The output has been reviewed and corrected, and I take responsibility for it matching this repo's conventions.

GPU vendors come from the PCI vendor ID, and Intel's discrete cards
(DG1, Alchemist, Battlemage) from the device ID. Names depend on the
pci.ids at hand: a Battlemage card was "Device e212" on Ubuntu 24.04
and took the Gen9+ path.

On Ubuntu the NVIDIA branch asked for libcuda1, which does not exist
there, and then for libnvidia-decode-<series>, which NVIDIA stopped
publishing with 590. It now picks libnvidia-compute with or without the
series in its name, whichever has the host's release, pins that version
and installs with the same flags as Debian. The version pin also covers
nvidia-*, since libnvidia-compute needs nvidia-persistenced at exactly
its own version.
@github-actions

Copy link
Copy Markdown
Contributor

Try this branch

The engine and the scripts resolve independently, so a production script can
be run against the engine from this PR by setting one variable:

COMMUNITY_SCRIPTS_CORE_URL=https://raw.githubusercontent.com/community-scripts/core/fix/hwaccel-gpu-ids-ubuntu-nvidia \
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/debian.sh)"

Swap ct/debian.sh for whatever exercises the change.

Run a script from a fork as well
curl -fsSL https://raw.githubusercontent.com/community-scripts/core/fix/hwaccel-gpu-ids-ubuntu-nvidia/tools/run.sh |
  bash -s -- https://raw.githubusercontent.com/YOU/DevScripts/your-branch ct/debian.sh \
             https://raw.githubusercontent.com/community-scripts/core/fix/hwaccel-gpu-ids-ubuntu-nvidia

Note that run.sh is reached through a pipe, so the script it starts inherits
an exhausted stdin. Whiptail is fine — it opens /dev/tty — but a plain read
would see EOF. The single-variable form above does not have that problem.

Useful flags while testing

dev_mode=net logs every engine fetch with status and duration, which is the
quickest way to confirm the branch is really being used. dev_mode=keep stops a
failed build from deleting the container along with the evidence.

@michelroegl-brunner
michelroegl-brunner merged commit 4aa3230 into main Nov 13, 2026
5 checks passed
@github-actions
github-actions Bot deleted the fix/hwaccel-gpu-ids-ubuntu-nvidia branch November 14, 2026 08:47
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.

2 participants