This document explains how to make use of NVIDIA 3D video hardware on a ["Debian"] GNU/Linux system by installing Nvidia's drivers the non-debian way. This page is necessary because formerly [NvidiaGraphicsDrivers] linked to it, but the link was dead. The Wayback Machine had a copy luckily. I have no time for digging into this wiki's syntax, so I'll just copy the content of , give it appropriate headers and let you decide on weather to fuse this with the other nvidia driver article.

Please note that the document is licensed under the FDL, so don't forget to include a license section

You also should rescue




This chapter will give you a short introduction on why to use the binary drivers published by NVIDIA and why there is a problem with those drivers concerning the idea of Open Source Software.

Some distributions inform their users during installation that there will be no 3D support by default. Why ? Because the NVIDIA drivers are built under the NVIDIA Software License, which is non-free. To avoid problems due to license conflicts, distributors do not include those software packages. Some others do provide those packages.

Nevertheless the Graphical User Interface does work well. Xserver and windowmanager will do their jobs properly because there is a free software clone of this nvidia-driver provided and developed by the DRI-Project.

So why don't use them? Of course you can use them. But notice, that they do not have 3D acceleration support, which you need to play OpenGL games such as Unreal Tournament or Quake.

This article will help you to install the closed-source driver modules to gain 3D support. [edit]

The X server

As most should already know GNU/Linux isn't just a kernel. You need at least one terminal to tell the kernel what to do. Of course you do not have to enter cryptical letters into the terminal because you can use your mouse and use graphical user interfaces (GUIs).

The X Window System provides the ability to use a mouse and get interfaces. It reads the mouse and the keyboard and gives you surface. Actually there are two possible X implementations : and XFree86. It does not matter which one you have installed because the NVIDIA drivers support both.

The configuration file for the X server is located in /etc/X11/ and is called xorg.conf or XF86Config (or XF86Config-4, for example on Debian). All these use the same syntax. We will need to edit this file later to activate the NVIDIA drivers. But let's go on with the installation.

Concerning the NVIDIA drivers

The NVIDIA drivers consist of those two parts:



To be able to install the drivers successfully, software with these versions (or above) is required:

If you use precompiled packages, such as apt-get (for Debian) or RPM (for SUSE and Red Hat):

There's more than one way

There are often two ways to perform the installation on your system. There is one NVIDIA-official way, nvidia-installer. The other way, when it exists, is the one your distribution recommends. While we try to list the most popular distro-specific methods, there is no methodic way to know if your distribution recommends to install the drivers with a different method than nvidia-installer. If you have no clue, you can ask your distribution's community, or just use nvidia-installer. If you have two possible ways to install, and one fails, you could obviously try the other one.

nvidia-installer is a clever cross-platform way of installing which works fine on systems with stupid package managers (i.e. not so good with Debian, etc.).

Distribution-specific methods

These methods have the advantage that they can't conflict with your distribution's package managers. They could also be more adapted to your system, or easier/harder to perform. One potential difference you should consider is the availability of the latest drivers release in your distribution. As always, the distributions's drivers always lag some time behind the official drivers. This is also a good way to be sure you won't be installing untested stuff. But if your distributions' drivers lag more than one release, consider using nvidia-installer.

Here are the most common distro-specific installation methods. If you choose one, you can skip the rest of the installation chapter, and the next chapter if your howto also covers it.


The Debian-nVidia HOWTO entirely explains the installation process for Debian GNU/Linux, or any of its derivatives including Libranet, Mepis, Ubuntu, or Xandros. You won't need to come back here.

Gentoo Linux

Gentoo's portage offers a complete NVIDIA installation. You only need to run

emerge -av nvidia-glx

The result should look like this:

Accept and start the installation by typing Yes. Finally you need to activate the new libraries. To do avoid lots of terminal commands Gentoo offers a script called opengl-update. If it is not already installed do install it using

emerge -av opengl-update

You link the libraries and headerfiles of NVIDIA by:

opengl-update nvidia


Use the official Nvidia Installer HOWTO for SuSE Linux users.

Recent versions of SUSE LINUX offer the possibility to do an Online Update with YOU.

  1. Start YOU using it's entry in your menu or directly run you as root.
  2. Select a mirror server and launch the manual update.
  3. Select fetchnvidia-1 .
  4. Read and accept the license.
  5. Quit you and restart your computer.

Installing with nvidia-installer

Downloading the drivers

NVIDIA has a portal for Linux users. nV News has a Linux forum. We recommend to use the most recent drivers. NVIDIA Linux Drivers Portal: here nV News's Linux forum: here Most recent drivers: 1.0-7676

X must be shutdown to install the drivers. For some systems, X is shutdown by default in runlevel 3, so the command init 3 does it. Some distributions offer a script to only shutdown X but as there are lots of distributions there are also lots of scripts for those. If your display manager is gdm and you're using Debian, /etc/init.d/gdm stop will do. There are similar ways if you use kdm, xdm, etc. If you have no clue, you should ask your distribution's community.

Run nvidia-installer

Execute the installer with Running the installer

sh /path/to/your/NVIDIA-Linux-x86-1.0-{VERSION}

Make sure you changed the {VERSION} to the one you downloaded.

Step by Step

  1. After launching the installer there will popup a messagebox wanting you to accept the license printed in the background. Read the license carefully and click accept if you like otherwise the installer will quit. Image:small_box_nvidia_installer_step1.png

  2. If you have a driver already installed the installer asks whether to uninstall it. Image:small_box_nvidia_installer_step2.png

  3. Next the installer will ask you whether it should download a precompiled driver package from You can choose both: Yes then No. Whatever you use the installer will (quite) surely need to compile it's own kernel interface.Image:small_box_nvidia_installer_step3.png

  4. Now the kernel module will be compiled. Image:small_box_nvidia_installer_step6.png

  5. After some time the compilation will be completed and the installer continues with the system installation... Image:small_box_nvidia_installer_step8.png

    • .. and the linking of the libraries (this may take some time) Image:small_box_nvidia_installer_step10.png

  6. Finally the installer prints: Image:small_box_nvidia_installer_step11.png

Note: If the installer complains that the gcc version is different from what was used to compile the kernel, use aptitude to install the appropriate gcc version (e.g. gcc-4.1) and run the command "export CC=gcc-4.1" before running the NVIDIA installer.

Loading the kernel module

Now you have installed the drivers, but usually they're not loaded. To check whether the driver is loaded yet type Command:



Module Size Used by nvidia 3462172 12

If it does not appear don't worry. You can easily load it via Loading the nvidia interface

modprobe nvidia

This should work without problems. Nevertheless things can happen. If you receive an error look through the Troubleshoots.

Avoid kernel troubles

NVIDIA drivers being non-free, they are not handled as well as most modules are. If you change your kernel, your nvidia module won't adapt automatically, while you'll need to recompile. When you install the nvidia driver it compiles a "kernel interface" to the currently running kernel. When you update your kernel (or your distribution's update facility does it for you) the NVIDIA installation will need re-running otherwise X will not start after you reboot (to load the kernel) and will typically flash the text login screen several times whilst it tries to start. This can be annoying. You can manually recompile your module everytime this happens, or to make the process easier you can employ a init script to update the kernel interface of your NVIDIA driver on boot up after a kernel install. An example of such script is shown below:

When you update your kernel simply touch the /etc/nvidia-update file and reboot (which you would have had to do any way to load the kernel). A refinement to this script would be to check if the nvidia module can be loaded and if not update the driver. Use the

/path/to/your/NVIDIA-Linux-x86-1.0-{VERSION} --advanced-options

command to see all options of nvidia-installer. You can also use the

/path/to/your/NVIDIA-Linux-x86-1.0-{VERSION} --update

command to install the latest driver available version from NVIDIA.

Setting up your system

We now configure the system to use the NVIDIA drivers and libraries correctly.

Autoload the drivers on startup

As already mentionned there are different way to succed. Same is valid here as different distributions offer different ways to autoload kernel modules.

As you might already know Linux distributions use runlevels to startup different servieces, such as network, CUPS (the print server), xdm (a display manager). If you look into your /etc/init.d/ folder you can see a list of all those available scripts. Some get launched on startup and some are optional. On most distributions there's one special initscript we want to use now. The name does differ a bit from system to system but in general it does contain words like: local and start. In this example it is called: local.start .

Linux platforms offer modprobe what can be used to load drivers (see #Loading the kernel module).

So we easily add this command to the end of the init script:

modprobe nvidia

As there are usually more scripts that are run during startup you only need to add this line to one of those scripts. You can even use the script to setup the sound to load the nvidia module.

Configuring the X server

Now the driver modules are loaded and will be loaded each startup. So the way is clear to configure the X server to use them and give 3D support. The main configuration file can be found in /etc/X11 . The filename depends on the X server used and sometimes the distribution. Generally they are: XFree86 : /etc/X11/XF86Config : /etc/X11/xorg.conf

Open your config file in your preferred text editor. For example if you like vim (and use (

vim /etc/X11/xorg.conf

Now you can see the contents in different Sections. The ones important for now are:

Section "Module"


Section "Device"

Module Section

Your Module section should look like this:

Section "Module" # Load "GLcore"

# Load "dri"

# 'There are certainly more modules booked here !' ?EndSection

Note: Make sure you commented out the 'dri' module, because nvidia already offers this module.

Device Section

Now X loads the libraries and the driver into its memory, but we need more. It should also access the nvidia hardware. So search the Device Section in your configuration file and change:

Driver nv


Driver nvidia

The whole section should now look like this:

Section "Device"

# Maybe coming more (optional) parts ?EndSection

Test the 3D acceleration

After setting up all the important options your X server needs to be restarted.

If you use a graphical login, where you can enter you username and password directly after boot it is sufficent to quit your local windowmanager or hardkill X by pressing:

Ctrl + Alt + Backspace

You will return to the graphical login.

If you do not use graphical login managers, just quit your session and rerun it.

Once you restarted X there a NVIDIA logo will appear before your login manager. This indicates that the NVIDIA drivers are installed correctly and loaded by X.

Last but not least you can check your 3D acceleration by launching: Command:

glxinfo | grep -i "direct rendering"


direct rendering: Yes

To see the 3D acceleration working smooth you can try



To Resolve Nvidia 177.67 X Driver Issues

If you are using the 177.67 X Nvidia drivers and experiencing performance issues using Compiz (such as the Gnome terminal taking forever to resize, etc.), it is likely due to settings that are incorrect or missing. Nvidia posted the following fix:

In summary, do the following:

- add these options to your X.Org configuration file:

- after starting X, run: