{"id":676,"date":"2025-10-29T16:38:54","date_gmt":"2025-10-29T15:38:54","guid":{"rendered":"https:\/\/tecnoitzi.com\/?p=676"},"modified":"2025-10-29T16:40:16","modified_gmt":"2025-10-29T15:40:16","slug":"proxmox-lxc-nvidia","status":"publish","type":"post","link":"https:\/\/tecnoitzi.com\/index.php\/2025\/10\/29\/proxmox-lxc-nvidia\/","title":{"rendered":"Proxmox LXC NVIDIA"},"content":{"rendered":"
<\/div>

<\/g><\/svg><\/i> \"Loading\"<\/p>

<\/div>\n

Publicado originalmente en jocke.no<\/a><\/em><\/p>\n\n\n\n

Tambi\u00e9n con informaci\u00f3n de theorangeone.net<\/a><\/em><\/p>\n\n\n\n

Host de Proxmox<\/h4>\n\n\n\n

El primer paso es instalar los controladores en el sistema anfitri\u00f3n. Nvidia cuenta con un repositorio oficial de Debian que podr\u00edamos usar. Sin embargo, esto presenta un problema potencial: necesitamos instalar los controladores en el contenedor LXC posteriormente, sin m\u00f3dulos del kernel. No encontr\u00e9 la manera de hacerlo usando los paquetes del repositorio oficial de Debian, por lo que tuve que instalar los controladores manualmente dentro del contenedor LXC. Otro aspecto importante es que tanto el sistema anfitri\u00f3n como el contenedor LXC deben ejecutar la misma versi\u00f3n del controlador (de lo contrario, no funcionar\u00e1). Si instalamos usando el repositorio oficial de Debian en el sistema anfitri\u00f3n e instalamos manualmente el controlador en el contenedor LXC, podr\u00edamos terminar f\u00e1cilmente con versiones diferentes (cada vez que ejecutemos `apt upgrade` en el sistema anfitri\u00f3n). Para lograr la mayor consistencia posible, instalaremos el controlador manualmente tanto en el sistema anfitri\u00f3n como dentro del contenedor LXC.<\/p>\n\n\n\n

echo -e \"blacklist nouveau\\noptions nouveau modeset=0\" > \/etc\/modprobe.d\/blacklist-nouveau.conf
update-initramfs -u
reboot<\/code><\/pre>\n\n\n\n
Instala las cabeceras PVE que coincidan con tu kernel actual.<\/p>\n\n\n\n
apt install pve-headers-$(uname -r)<\/code><\/pre>\n\n\n\n
Descargar e instalar el controlador de Nvidia<\/h4>\n\n\n\n
Nota: La versi\u00f3n 520.56.06 era la m\u00e1s reciente al momento de escribir este documento; sin embargo, consulte https:\/\/download.nvidia.com\/XFree86\/Linux-x86_64\/<\/a> para obtener controladores m\u00e1s recientes.<\/p>\n\n\n\n
Responda \u00abno\u00bb cuando le pregunte si desea instalar controladores de compatibilidad de 32 bits.<\/p>\n\n\n\n
Responda \u00abno\u00bb cuando le pregunte si debe actualizar la configuraci\u00f3n X.<\/p>\n\n\n\n
wget -O NVIDIA-Linux-x86_64.run https:\/\/download.nvidia.com\/XFree86\/Linux-x86_64\/520.56.06\/NVIDIA-Linux-x86_64-520.56.06.run
chmod +x NVIDIA-Linux-x86_64.run
.\/NVIDIA-Linux-x86_64.run --check
.\/NVIDIA-Linux-x86_64.run<\/code><\/pre>\n\n\n\n
Una vez instalados los controladores, debemos a\u00f1adir algunas reglas udev. Esto garantiza que se carguen los m\u00f3dulos del kernel adecuados y que se creen todos los archivos de dispositivo necesarios al arrancar el sistema.<\/p>\n\n\n\n
Agregar m\u00f3dulos del kernel<\/p>\n\n\n\n
echo -e '\\n# load nvidia modules\\nnvidia\\nnvidia_uvm\\nnvidia-drm\\nnvidia-uvm' >> \/etc\/modules-load.d\/modules.conf<\/code><\/pre>\n\n\n\n
Una vez hecho esto, tendr\u00e1s que actualizar el initramfs.<\/p>\n\n\n\n
update-initramfs -u -k all.<\/code><\/pre>\n\n\n\n
A\u00f1ade lo siguiente a \/etc\/udev\/rules.d\/70-nvidia.rules. Esto crear\u00e1 los archivos de dispositivo correspondientes en \/dev\/ durante el arranque.<\/p>\n\n\n\n
nano \/etc\/udev\/rules.d\/70-nvidia.rules<\/code><\/pre>\n\n\n\n
KERNEL==\"nvidia\", RUN+=\"\/bin\/bash -c '\/usr\/bin\/nvidia-smi -L && \/bin\/chmod 666 \/dev\/nvidia*'\"
KERNEL==\"nvidia_uvm\", RUN+=\"\/bin\/bash -c '\/usr\/bin\/nvidia-modprobe -c0 -u && \/bin\/chmod 0666 \/dev\/nvidia-uvm*'\"
SUBSYSTEM==\"module\", ACTION==\"add\", DEVPATH==\"\/module\/nvidia\", RUN+=\"\/usr\/bin\/nvidia-modprobe -m\"<\/code><\/pre>\n\n\n\n
Para evitar que el controlador\/m\u00f3dulo del kernel se descargue cuando la GPU no se utilice, debemos ejecutar el servicio de persistencia<\/a> proporcionado por Nvidia . Este servicio estar\u00e1 disponible tras la instalaci\u00f3n del controlador.<\/p>\n\n\n\n
Copiar y extraer<\/p>\n\n\n\n
cp \/usr\/share\/doc\/NVIDIA_GLX-1.0\/samples\/nvidia-persistenced-init.tar.bz2 .
bunzip2 nvidia-persistenced-init.tar.bz2
tar -xf nvidia-persistenced-init.tar<\/code><\/pre>\n\n\n\n
Retire las piezas antiguas, si las hubiera (para evitar un servicio enmascarado).<\/p>\n\n\n\n
rm \/etc\/systemd\/system\/nvidia-persistenced.service<\/code><\/pre>\n\n\n\n
Instalar<\/p>\n\n\n\n
chmod +x nvidia-persistenced-init\/install.sh
.\/nvidia-persistenced-init\/install.sh<\/code><\/pre>\n\n\n\n
Comprueba que est\u00e9 bien.<\/p>\n\n\n\n
systemctl status nvidia-persistenced.service
rm -rf nvidia-persistenced-init*<\/code><\/pre>\n\n\n\n
Si has llegado hasta aqu\u00ed sin ning\u00fan error, ya puedes reiniciar el host Proxmox. Tras el reinicio, deber\u00edas ver la siguiente informaci\u00f3n (el tipo\/informaci\u00f3n de la GPU, por supuesto, cambiar\u00e1 dependiendo de tu GPU);<\/p>\n\n\n\n
nvidia-smi<\/code><\/pre>\n\n\n\n
Producci\u00f3n<\/p>\n\n\n\n
Wed Feb 23 01:34:17 2022
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 520.56.06    Driver Version: 520.56.06    CUDA Version: 11.8     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage\/Cap|         Memory-Usage | GPU-Util  Compute M. |
|                               |                      |               MIG M. |
|===============================+======================+======================|
|   0  NVIDIA RTX A2000    On   | 00000000:82:00.0 Off |                  Off |
| 30%   36C    P2    4W \/  70W |       1MiB \/  6138MiB |     0%       Default |
|                               |                      |                  N\/A |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                                  |
|  GPU   GI   CI        PID   Type   Process name                  GPU Memory |
|        ID   ID                                                   Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+
<\/code><\/pre>\n\n\n\n
systemctl status nvidia-persistenced.service<\/code><\/pre>\n\n\n\n
Producci\u00f3n<\/p>\n\n\n\n
\u25cf nvidia-persistenced.service - NVIDIA Persistence Daemon
     Loaded: loaded (\/lib\/systemd\/system\/nvidia-persistenced.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2022-02-23 00:18:04 CET; 1h 16min ago
    Process: 9300 ExecStart=\/usr\/bin\/nvidia-persistenced --user nvidia-persistenced (code=exited, status=0\/SUCCESS)
   Main PID: 9306 (nvidia-persiste)
      Tasks: 1 (limit: 154511)
     Memory: 512.0K
        CPU: 1.309s
     CGroup: \/system.slice\/nvidia-persistenced.service
             \u2514\u25009306 \/usr\/bin\/nvidia-persistenced --user nvidia-persistenced

Feb 23 00:18:03 foobar systemd[1]: Starting NVIDIA Persistence Daemon...
Feb 23 00:18:03 foobar nvidia-persistenced[9306]: Started (9306)
Feb 23 00:18:04 foobar systemd[1]: Started NVIDIA Persistence Daemon.

root@foobar:~# ls -alh \/dev\/nvidia*
crw-rw-rw- 1 root root 195,   0 Feb 23 00:17 \/dev\/nvidia0
crw-rw-rw- 1 root root 195, 255 Feb 23 00:17 \/dev\/nvidiactl
crw-rw-rw- 1 root root 195, 254 Feb 23 00:17 \/dev\/nvidia-modeset
crw-rw-rw- 1 root root 511,   0 Feb 23 00:17 \/dev\/nvidia-uvm
crw-rw-rw- 1 root root 511,   1 Feb 23 00:17 \/dev\/nvidia-uvm-tools<\/code><\/pre>\n\n\n\n
Si nvidia-smi muestra la GPU correcta, el servicio de persistencia funciona correctamente y los cinco archivos est\u00e1n disponibles, estamos listos para proceder al contenedor LXC.<\/p>\n\n\n\n
contenedor LXC<\/h2>\n\n\n\n
Necesitamos a\u00f1adir la configuraci\u00f3n LXC pertinente a nuestro contenedor. Apague el contenedor LXC y realice los siguientes cambios en el archivo de configuraci\u00f3n LXC;<\/p>\n\n\n\n
Edita el archivo \/etc\/pve\/lxc\/1xx.conf y a\u00f1ade lo siguiente:<\/p>\n\n\n\n
lxc.cgroup2.devices.allow: c 195:* rwm
lxc.cgroup2.devices.allow: c 509:* rwm
lxc.cgroup2.devices.allow: c 511:* rwm
lxc.mount.entry: \/dev\/nvidia0 dev\/nvidia0 none bind,optional,create=file
lxc.mount.entry: \/dev\/nvidiactl dev\/nvidiactl none bind,optional,create=file
lxc.mount.entry: \/dev\/nvidia-modeset dev\/nvidia-modeset none bind,optional,create=file
lxc.mount.entry: \/dev\/nvidia-uvm dev\/nvidia-uvm none bind,optional,create=file
lxc.mount.entry: \/dev\/nvidia-uvm-tools dev\/nvidia-uvm-tools none bind,optional,create=file<\/code><\/pre>\n\n\n\n
Los n\u00fameros en las l\u00edneas de cgroup2 provienen de la quinta columna de la lista de dispositivos anterior (obtenida con `ls -alh \/dev\/nvidia*`). En mi caso, los dos archivos nvidia-uvm cambian aleatoriamente entre 509 y 511, mientras que los otros tres permanecen est\u00e1ticos en 195. Desconozco el motivo de esta alternancia (si sabes c\u00f3mo establecerlos en un valor fijo, te agradecer\u00eda que me lo indicaras), pero LXC no muestra ning\u00fan error al configurar n\u00fameros que no existen (es decir, podemos a\u00f1adir los tres para comprobar que funciona).<\/p>\n\n\n\n
Ahora podemos activar el contenedor LXC y estaremos listos para instalar el controlador de Nvidia. Esta vez lo instalaremos sin los controladores del kernel, por lo que no es necesario instalar las cabeceras del kernel.<\/p>\n\n\n\n
Responda \u00abno\u00bb cuando le pregunte si debe actualizar la configuraci\u00f3n X.<\/em><\/p>\n\n\n\n
wget -O NVIDIA-Linux-x86_64.run https:\/\/download.nvidia.com\/XFree86\/Linux-x86_64\/520.56.06\/NVIDIA-Linux-x86_64-520.56.06.run
chmod +x NVIDIA-Linux-x86_64.run
.\/NVIDIA-Linux-x86_64.run --check
.\/NVIDIA-Linux-x86_64.run --no-kernel-module<\/code><\/pre>\n\n\n\n
En este punto, ya deber\u00eda poder reiniciar su contenedor LXC. Verifique que los archivos y el controlador funcionen correctamente antes de continuar con la configuraci\u00f3n de Docker.<\/p>\n\n\n\n
ls -alh \/dev\/nvidia*<\/code><\/pre>\n\n\n\n
Producci\u00f3n<\/p>\n\n\n\n
crw-rw-rw- 1 root root 195,   0 Feb 23 00:17 \/dev\/nvidia0
crw-rw-rw- 1 root root 195, 255 Feb 23 00:17 \/dev\/nvidiactl
crw-rw-rw- 1 root root 195, 254 Feb 23 00:17 \/dev\/nvidia-modeset
crw-rw-rw- 1 root root 511,   0 Feb 23 00:17 \/dev\/nvidia-uvm
crw-rw-rw- 1 root root 511,   1 Feb 23 00:17 \/dev\/nvidia-uvm-tools<\/code><\/pre>\n\n\n\n
Ejecutar nvidia-smi<\/p>\n\n\n\n
nvidia-smi<\/code><\/pre>\n\n\n\n
Producci\u00f3n<\/p>\n\n\n\n
Wed Feb 23 01:50:15 2022
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 520.56.06    Driver Version: 520.56.06    CUDA Version: 11.8     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage\/Cap|         Memory-Usage | GPU-Util  Compute M. |
|                               |                      |               MIG M. |
|===============================+======================+======================|
|   0  NVIDIA RTX A2000    Off  | 00000000:82:00.0 Off |                  Off |
| 30%   34C    P8    10W \/  70W |      3MiB \/  6138MiB |      0%      Default |
|                               |                      |                  N\/A |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                                  |
|  GPU   GI   CI        PID   Type   Process name                  GPU Memory |
|        ID   ID                                                   Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+<\/code><\/pre>\n\n\n\n
contenedor Docker<\/h2>\n\n\n\n
Ahora podemos proceder a configurar Docker. Usaremos docker-compose y nos aseguraremos de tener la \u00faltima versi\u00f3n eliminando las versiones de Docker y docker-compose proporcionadas por Debian. Tambi\u00e9n instalaremos el entorno de ejecuci\u00f3n de Docker proporcionado por Nvidia<\/a> . Ambos son necesarios para que la GPU est\u00e9 disponible en Docker.<\/p>\n\n\n\n
Eliminar paquetes proporcionados por Debian<\/p>\n\n\n\n
apt remove docker-compose docker docker.io containerd runc<\/code><\/pre>\n\n\n\n
Instala Docker desde el repositorio oficial<\/p>\n\n\n\n
apt update
apt install ca-certificates curl gnupg lsb-release
curl -fsSL https:\/\/download.docker.com\/linux\/debian\/gpg | gpg --dearmor -o \/usr\/share\/keyrings\/docker-archive-keyring.gpg
echo \\
  \"deb [arch=$(dpkg --print-architecture) signed-by=\/usr\/share\/keyrings\/docker-archive-keyring.gpg] https:\/\/download.docker.com\/linux\/debian \\
  $(lsb_release -cs) stable\" | tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null

apt update
apt install docker-ce docker-ce-cli containerd.io<\/code><\/pre>\n\n\n\n
Instalar docker-compose<\/p>\n\n\n\n
curl -L \"https:\/\/github.com\/docker\/compose\/releases\/download\/1.29.2\/docker-compose-$(uname -s)-$(uname -m)\" -o \/usr\/local\/bin\/docker-compose
chmod +x \/usr\/local\/bin\/docker-compose<\/code><\/pre>\n\n\n\n
Instalar la funci\u00f3n de autocompletado de docker-compose bash<\/p>\n\n\n\n
curl \\
    -L https:\/\/raw.githubusercontent.com\/docker\/compose\/1.29.2\/contrib\/completion\/bash\/docker-compose \\
    -o \/etc\/bash_completion.d\/docker-compose<\/code><\/pre>\n\n\n\n
Instalar nvidia-docker2<\/p>\n\n\n\n
apt install -y curl
distribution=$(. \/etc\/os-release;echo $ID$VERSION_ID)
keyring_file=\"\/usr\/share\/keyrings\/nvidia-container-toolkit-keyring.gpg\"
curl -fsSL https:\/\/nvidia.github.io\/libnvidia-container\/gpgkey | gpg --dearmor -o ${keyring_file}
curl -s -L https:\/\/nvidia.github.io\/libnvidia-container\/$distribution\/libnvidia-container.list | \\
  sed \"s#deb https:\/\/#deb [signed-by=${keyring_file}] https:\/\/#g\" | \\
  tee \/etc\/apt\/sources.list.d\/nvidia-container-toolkit.list

apt update
apt install nvidia-docker2<\/code><\/pre>\n\n\n\n
Reinicia systemd + docker (si no recargas systemd, puede que no funcione).<\/p>\n\n\n\n
systemctl daemon-reload
systemctl restart docker<\/code><\/pre>\n\n\n\n
Ahora deber\u00edamos poder ejecutar contenedores Docker con soporte para GPU. Vamos a probarlo.<\/p>\n\n\n\n
docker run --rm --gpus all nvidia\/cuda:11.8.0-devel-ubuntu22.04 nvidia-smi<\/code><\/pre>\n\n\n\n
Producci\u00f3n<\/p>\n\n\n\n
Tue Feb 22 22:15:14 2022
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 520.56.06    Driver Version: 520.56.06    CUDA Version: 11.8     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage\/Cap|         Memory-Usage | GPU-Util  Compute M. |
|                               |                      |               MIG M. |
|===============================+======================+======================|
|   0  NVIDIA RTX A2000    Off  | 00000000:82:00.0 Off |                  Off |
| 30%   29C    P8     4W \/  70W |      1MiB \/  6138MiB |      0%      Default |
|                               |                      |                  N\/A |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                                  |
|  GPU   GI   CI        PID   Type   Process name                  GPU Memory |
|        ID   ID                                                   Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+<\/code><\/pre>\n\n\n\n
Probando que todo funciona<\/h2>\n\n\n\n
Una forma sencilla de comprobar que todo funciona es a\u00f1adir un contenedor FileFlows.<\/p>\n\n\n\n
nano docker-compose.yml<\/code><\/pre>\n\n\n\n
version: '3.7'
services:
  fileflows:
    image: revenz\/fileflows
    container_name: fileflows
    runtime: nvidia
    stdin_open: true # docker run -i
    tty: true        # docker run -t
    environment:
      - TZ=Pacific\/Auckland
      - TempPathHost=\/temp
      - NVIDIA_DRIVER_CAPABILITIES=compute,video,utility
      - NVIDIA_VISIBLE_DEVICES=all
    volumes:
      - \/var\/run\/docker.sock:\/var\/run\/docker.sock:ro
      - \/mnt\/docker\/fileflows\/data:\/app\/Data 
      - \/mnt\/docker\/fileflows\/logs:\/app\/Logs
      - \/mnt\/docker\/fileflows\/temp:\/temp
    ports:
      - 19200:5000
    restart: unless-stopped<\/code><\/pre>\n\n\n\n
Ejecutar el contenedor<\/p>\n\n\n\n
docker-compose up<\/code><\/pre>\n\n\n\n
Luego, ejecuta una prueba de ffmpeg para NVIDIA.<\/p>\n\n\n\n
ffmpeg -loglevel error -f lavfi -i color=black:s=1920x1080 -vframes 1 -an -c:v hevc_nvenc -f null -<\/code><\/pre>\n\n\n\n
Si el comando se ejecuta sin errores, \u00a1todo funciona correctamente!<\/p>\n","protected":false},"excerpt":{"rendered":"
<\/div>\n
<\/g><\/svg><\/i> \"Loading\"<\/p>\n
<\/div>\n
Publicado originalmente en jocke.no Tambi\u00e9n con informaci\u00f3n de theorangeone.net Host de Proxmox El primer paso es instalar los controladores en…<\/p>\n","protected":false},"author":1,"featured_media":624,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[33,32],"tags":[],"class_list":["post-676","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-homelab","category-proxmox"],"a3_pvc":{"activated":true,"total_views":33,"today_views":0},"_links":{"self":[{"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/posts\/676","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/comments?post=676"}],"version-history":[{"count":2,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/posts\/676\/revisions"}],"predecessor-version":[{"id":678,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/posts\/676\/revisions\/678"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/media\/624"}],"wp:attachment":[{"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/media?parent=676"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/categories?post=676"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tecnoitzi.com\/index.php\/wp-json\/wp\/v2\/tags?post=676"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}