Importante: Sway no funciona con los controladores oficiales de nvidia. Fuente: Documentación de sway en el sitio de debian, actualizado al 15 de marzo de 2026.

Los usuarios de sway contamos con los controladores de código abierto de nouveou, pero, en ocasiones, necesitamos utilizar programas de inteligencia artificial (IA) que dependen de cuda para tener un mejor rendimiento. Dicha biblioteca requiere del controlador oficial de nvidia y, por ello, en este artículo describo como instalarla en Debian.

El primer paso es actualizar el ordenador.

1apt update
2apt upgrade
3apt autoremove
4systemctl reboot

A continuación debemos de revisar y tomar nota de la versión de la tarjeta controladora que tenemos instalada.

1$ lspci | grep -i nvidia

Ahora, agregaremos los repositorios contrib y non-free a la configuración de debian en /etc/apt/sources.list.

1deb http://deb.debian.org/debian/ trixie main contrib non-free non-free-firmware
2deb-src http://deb.debian.org/debian/ trixie main contrib non-free non-free-firmware
3
4deb http://security.debian.org/debian-security trixie-security main contrib non-free non-free-firmware

Actualizamos las listas de programas disponibles, instalamos el programa de detección de tarjetas de nvidia y lo ejecutamos.

1apt update
2apt install nvidia-detect
3nvidia-detect

El programa nos recomendará el controlador a instalar. En mi caso, instalaré el controlador más reciente, llamado nvidia-driver y reiniciaré el ordenador.

1apt install nvidia-driver
2systemctl reboot

El siguiente programa nos permitirá verificar que todo haya funcionado bien,

1nvidia-smi

Que en mi caso, no ha sido así. He tenido que:

1. Verificar que el controlador de nouveau haya sido desactivado, buscando un fichero como el siguiente,

1$ cat /etc/modprobe.d/nvidia-blacklists-nouveau.conf
2# You need to run "update-initramfs -u" after editing this file.
3
4# see #580894
5blacklist nouveau

y que podemos crear si no existe, seguido del siguiente comando que aplicará los cambios:

1update-initramfs -u

2. Instalar el paquete de cabeceras de linux,

1apt install linux-headers-amd

el cual automáticamente compilará ficheros necesarios para el controlador de nvidia;

3. Reiniciar el ordenador:

1systemctl reboot

Tras reiniciar, el comando nvidia-smi funcionó como esperaba.

Como último paso, instalaremos el paquete de cuda,

1apt install nvidia-cuda-toolkit
2apt autoremove

Conclusión

Instalar el controlador oficial de nvidia es relativamente sencillo, pero requiere paciencia. Aunque el proceso me ha hecho sopesar entre el tener acceso al GPU vía cuda o el continuar usando Sway, que ha sido mi ambiente gráfico por un tiempo y me encanta. Con el controlador de nvidia activo, sway imprime el siguiente error cuando intento ejecutarlo:

1$ sway
200:00:00.010 [wlr] [backend/backend.c:253] Found 0 GPUs, cannot create backend
300:00:00.010 [wlr] [backend/backend.c:428] Failed to open any DRM device
400:00:00.025 [sway/server.c:228] Unable to create backend

Aunque he leído del argumento --unsupported-gpu, éste no funciona en la versión de sway que acompaña a debian trixie. Difícil situación, aunque la balanza se inclina del lado de sway ❤️.

Referencias

• Sojitra, Adarsh. Installing Nvidia Graphics Drivers on Debian 13: A Complete Guide.