An Ansible role that configures the vGPU unlock hack on a Proxmox VE 7.2 host.

This tutorial assumes you are using a clean install of Proxmox 7.2, or ymmv when using an existing installation. Make sure to always have backups!

This role requires that you get a hold of the Nvidia vGPU driver version 510.85.03 for linux kvm. Details on how to obtain it can be found here.

Once you obtained the driver file, make sure to place it in the /opt/ directory before running the role. An example playbook is listed below.

To check the default variables, take a look at the defaults file.

Note: The roles defined in the dependencies can also have their variables customized. Take a look at their readmes for more information.

• proxmox_no_subscription
• proxmox_iommu
• proxmox_vfio
• proxmox_driver_blacklist
• rust

---
- name: Enable vGPU on all PVE hosts
  hosts: pve
  remote_user: root

  pre_tasks:
    - name: Copy Nvidia Driver package
      ansible.builtin.copy:
        src: "files/NVIDIA-Linux-x86_64-510.85.03-vgpu-kvm.run"
        dest: "/opt/NVIDIA-Linux-x86_64-510.85.03-vgpu-kvm.run"
        owner: root
        group: root
        mode: u=rwx,g=rwx,o=r

  roles:
    - role: mirceanton.proxmox_vgpu

MIT

This project would not have been possible without the work and help of these people:

• DualCoder for his original vgpu_unlock repo with the kernel hooks
• mbilker for the rust version, vgpu_unlock-rs
• KrutavShah for the wiki
• HiFiPhile for the C version of vgpu unlock
• rupansh for the original twelve.patch to patch the driver on kernels >= 5.12
• PolloLoco for the guide and support via discord
• mbuchel#1878 on the GPU Unlocking discord for fourteen.patch to patch the driver on kernels >= 5.14
• erin-allison for the nvidia-smi wrapper script
• LIL'pingu#9069 on the GPU Unlocking discord for his patch to nop out code that NVIDIA added to prevent usage of drivers with a version >= 460 with consumer cards
• The GPU Unlocking discord community

A role developed by Mircea-Pavel ANTON.