guideos-nvidia-installer

This project is a fork/derivative work of the original debian-nvidia-installer created by Leonardo Amaral. Due to downstream compatibility adjustments and workflow preferences, this project is maintained independently here.

Licensed under the GNU General Public License v3.0 (see LICENSE).

NVIDIA driver installer with a Bash TUI. This tool allows you to install NVIDIA drivers on Debian using an interactive text-based interface (TUI). It automates steps such as package installation, compatibility checks, and graphics environment configuration.

Requirements

• Debian Trixie distribution

• amd64 architecture

• Compatible NVIDIA graphics card

  Official NVIDIA drivers on Debian Trixie do not support GPUs based on the Fermi or Kepler architecture.

  See Debian’s guide on installing legacy drivers if needed.

• Bash-compatible shell

• Administrator privileges (sudo/root)

How to Run

After installation, you can start the script through the shortcut in the applications menu or via the terminal by running the command:

sudo debian-nvidia-installer

⚠️ It is necessary to run as root, as the tool makes system changes such as installing packages and modifying configuration files.

Installation

You can install debian-nvidia-installer by downloading the .deb package from the Releases section of this repository.

Option 1: Graphical Interface

1. Download the .deb package.
2. Double-click the file to open it with your system's package manager.
3. Click “Install”. You may be prompted to enter your administrator password.

💡 Compatible with package managers such as GDebi, Discover (KDE), GNOME Software, and similar tools.

Option 2: Terminal

Before starting, check the version of the .deb package you downloaded from GitHub. Replace X.X.X in the commands below with the correct version. For example, if the version is 0.0.1, the file will be debian-nvidia-installer_0.0.1_amd64.deb.

Copy the .deb file to the /tmp directory to avoid permission issues with the system package manager:

cp ./debian-nvidia-installer_X.X.X_amd64.deb /tmp/

💡 Files in the /tmp directory are automatically removed after a system reboot.

Change to the temporary directory /tmp, where the .deb file was moved:

cd /tmp

Install the package using apt so that the script dependencies are installed correctly:

sudo apt install ./debian-nvidia-installer_X.X.X_amd64.deb

⚠️ Important: Do not install using dpkg -i, as this will not resolve the package dependencies and the package may break.

Option 3: Build and install manually (for advanced users)

Clone the repository locally on your computer using git:

git clone https://github.com/devleonardoamaral/debian-nvidia-installer.git

Change to the cloned repository directory:

cd debian-nvidia-installer

Run the build script provided in the repository. It will create the .deb package in ./deb_build/debian-nvidia-installer_X.X.X_amd64.deb:

./build_deb.sh

To install the .deb package, follow the same steps as in Option 1: Graphical Interface or Option 2: Terminal.

Uninstallation

To completely remove the script and its dependencies, run the following command:

sudo apt purge --autoremove debian-nvidia-installer