Difference between revisions of "Nouveau"

From ArchWiki
Jump to navigation Jump to search
m (added Supported Hardware section to loosely mirror the nvidia page)
(Remove duplication, already said in introduction.)
Line 21: Line 21:
For OpenGL support, also install {{Pkg|mesa-libgl}}, and {{Pkg|lib32-mesa-libgl}} when using [[multilib]].
For OpenGL support, also install {{Pkg|mesa-libgl}}, and {{Pkg|lib32-mesa-libgl}} when using [[multilib]].
=== Supported GPU Hardware ===
Check the [https://nouveau.freedesktop.org/wiki/FeatureMatrix/ nouveau FeatureMatrix] to see if, or how well, your card is supported. Check [https://nouveau.freedesktop.org/wiki/CodeNames/ nouveau CodeNames] to find the code used for your card in the FeatureMatrix.
== Loading ==
== Loading ==

Revision as of 02:36, 29 June 2016


This article covers installing and configuring the Nouveau open-source driver for NVIDIA graphic cards. For information about the official proprietary driver, see NVIDIA.

Find your card's codename (a more detailed list is available on Wikipedia), and compare it with the feature matrix for supported features.


Install the xf86-video-nouveau package. It provides the DDX driver for 2D acceleration in Xorg, and pulls in mesa as a dependency which provides the DRI driver for 3D acceleration.

For OpenGL support, also install mesa-libgl, and lib32-mesa-libgl when using multilib.


The Nouveau kernel module should load automatically on system boot. If it does not happen, then:

  • Make sure you do not have nomodeset or vga= as a kernel parameter, since Nouveau requires kernel mode-setting.
  • Also, check that you have not disabled Nouveau by using any modprobe blacklisting within /etc/modprobe.d/ or /usr/lib/modprobe.d/.
  • If all above still fails to load nouveau check dmesg for opcode error. Add nouveau.config=NvBios=PRAMIN to your Kernel parameters to prevent module unloading.[1]

Enable early KMS

Tip: If you have problems with the resolution, check Kernel mode setting#Forcing modes and EDID.

Kernel mode setting (KMS) is required by the Nouveau driver. By default, the KMS is done after the other kernel modules are loaded. You will see the text "Loading modules" and the size of the text may change, possibly with an undesirable flicker. See the Nouveau KernelModeSetting page for more details.

It is also possible to start the KMS as early as possible in the boot process, when the initramfs is loaded.

To do this, add nouveau to the MODULES array in /etc/mkinitcpio.conf:

MODULES="... nouveau ..."

If you are using a custom EDID file, you should embed it into initramfs as well:


Re-generate the initial ramdisk image:

# mkinitcpio -p <kernel preset; e.g. linux>

If you're experiencing troubles with Nouveau leading to rebuild nouveau-drm several times for testing purposes, do not add nouveau to the initramfs. It is too easy to forget to rebuild the initramfs and it will just make any testing harder. Just use "Late start" until you are confident the system is stable. There might be additional problems with initramfs if you need a custom firmware (generally not advised).

Tips and tricks

Keep NVIDIA driver installed

If you want to keep the proprietary NVIDIA driver installed (and are not using OpenGL), but want to use the Nouveau driver, comment out nouveau blacklisting in /etc/modprobe.d/nouveau_blacklist.conf or /usr/lib/modprobe.d/nvidia.conf modifying it as follows:

#blacklist nouveau

And tell Xorg to load nouveau instead of nvidia by creating the file /etc/X11/xorg.conf.d/20-nouveau.conf with the following content:

Section "Device"
    Identifier "Nvidia card"
    Driver "nouveau"
Tip: You can use these scripts if you are switching between open and closed drivers often.

If you already used the NVIDIA driver, and want to test Nouveau without reboot, make sure the 'nvidia' module is no longer loaded:

# rmmod nvidia

Then load the 'nouveau' module:

# modprobe nouveau

And check that it loaded fine by looking at kernel messages:

$ dmesg

Installing the latest development packages

You may install the latest -git packages, through AUR:

Upstream driver sources can be found at the Nouveau Source page.

Dual Head

Nouveau supports the xrandr extension for modesetting and multiple monitors. See the xrandr page for tutorials.

Here is a full sample /etc/X11/xorg.conf.d/20-nouveau.conf above for running 2 monitors in dual head mode. You may prefer to use a graphical tool to configure monitors like GNOME Control Center's Display panel (gnome-control-center display).

# the right one
Section "Monitor"
          Identifier   "NEC"
          Option "PreferredMode" "1280x1024_60.00"

# the left one
Section "Monitor"
          Identifier   "FUS"
          Option "PreferredMode" "1280x1024_60.00"
          Option "LeftOf" "NEC"

Section "Device"
    Identifier "nvidia card"
    Driver "nouveau"
    Option  "Monitor-DVI-I-1" "NEC"
    Option  "Monitor-DVI-I-2" "FUS"

Section "Screen"
    Identifier "screen1"
   Monitor "NEC"
    DefaultDepth 24
      SubSection "Display"
       Depth      24
       Virtual 2560 2048
    Device "nvidia card"

Section "ServerLayout"
    Identifier "layout1"
    Screen "screen1"

Setting console resolution

Use the fbset tool to adjust console resolution.

You can also pass the resolution to nouveau with the video= kernel line option (see KMS).

Power Management

GPU Scaling is in various stages of readiness depending on the GPU. After kernel 3.18 there's power management available in kernel. If you plan to play games you need to enable the power state on the module configuration by adding nouveau.pstate=1 to the module configuration. This will result in higher clocks when required.

See the Nouveau PowerManagement page for more details.

Fan Control

If it is implemented for you card you can configure fan control via /sys.

$ find /sys -name pwm1_enable
$ readlink /sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0/driver

pwm1_enable can be set to 0, 1 or 2 meaning NONE, MANUAL and AUTO fan control. If set to manual fan control, you can set pwm1 manually, for example to 40 for 40%.

Warning: Use at your own risk! Don't overheat your card!

You can also set it by udev rule:

$ cat /etc/udev/rules.d/50-nouveau-hwmon.rules
ACTION=="add", SUBSYSTEM=="hwmon", DRIVERS=="nouveau", ATTR{pwm1_enable}="2"



You have two solutions to use Optimus on a laptop (aka hybrid graphics, when you have two GPUs on your laptop): bumblebee and PRIME


Add drm.debug=14 and log_buf_len=16M to your kernel parameters to turn on video debugging:

Create verbose Xorg log:

$ startx -- -logverbose 9 -verbose 9

View loaded video module parameters and values:

$ modinfo -p video

Disable MSI

If you are still having problems loading the module or starting X server append nouveau.config=NvMSI=0 to your Kernel parameters.

Source: https://bugs.freedesktop.org/show_bug.cgi?id=78441

Phantom Output Issue

It is possible for the nouveau driver to detect "phantom" outputs. For example, both VGA-1 and LVDS-1 are shown as connected but only LVDS-1 is present.

This causes display problems and a corrupted screen.

The problem can be overcome by disabling the phantom output (VGA-1 in the examples given) on the kernel command line of your boot loader. This can be achieved by appending the following:


Where d = disable.

The phantom output can also be disabled in X by adding the following to /etc/X11/xorg.conf.d/20-nouveau.conf:

Section "Monitor"
Identifier "VGA-1"
Option "Ignore" "1"

Source: http://gentoo-en.vfose.ru/wiki/Nouveau#Phantom_and_unpopulated_output_connector_issues

Random lockups with kernel error messages

Specific Nvidia chips with Nouveau may give random system lockups and more commonly throw many kernel messages, seen with dmesg. Try adding the nouveau.noaccel=1 kernel parameter. See [2] for more information.