1. Home
  2. Docs
  3. Hardware and Network
  4. Nvidia installer

Nvidia installer

by joekamprad

As most newer cards will work with the latest (called nvidia) driver some older cards are not longer supported by the latest driver.

The first thing you should do is get knowledge about your card and supported driver:

Latest changes on supported Cards by Driver versions:

newly moved to legacy:
  • 390xx –> works with xorg 1.20 (current version)

GeForce 400/500/600 series cards [NVCx and NVDx]

So called unsupported drivers:

  • 340xx –> unsupported use Nouveau

GeForce 8/9, ION and 100-300 series cards [NV5x, NV8x, NV9x and NVAx]

  • 304xx –> unsupported use Nouveau

For GeForce 6/7 series cards [NV4x and NV6x]

  • 173xx –> unsupported use Nouveau

GeForce 5 FX series cards [NV30-NV36]

  • 96xx –> unsupported use Nouveau

GeForce 2/3/4 MX/Ti series cards [NV11, NV17-NV28]

nvidia-installer only supports the latest driver and nvidia-390xx

To see what driver version support your card go here:


Put in the info for your card, and choose Linux-64bit as OS.

All supported cards for nvidia-390xx:


For GeForce it seems to show all drivers only on this page:


nvidia-installer and nvidia-installer-dkms:

We do offers a script formaly developed for Antergos by karasu and forked to use it now under EndeavourOS.

nvidia-installer-dkms is installed by default and can be used easily to install and remove propritary nvidia drivers and is able to install also for hybrid card systems (bumblebee {nvidia-intel-combo} )

We choose to install the dkms version by default to keep drivers installed and updated for all kernels you may install.

nvidia-installer-dkmsuses dkms driver versions instead of non-dkms. This means that you can install the Nvidia drivers also on other kernel versions like LTS, Zen and Hardened. Using installer’s dkms version also means, you need to install kernel header packages according to your installed kernel(s).

(example for linux-lts: sudo pacman -S linux-lts-headers

More info on dkms:


This is a list of all options for the script:

nvidia-installer-dkms -h (shows help)

usage: nvidia-installer-dkms [-h] [-b] [-f] [-t] [-q] [-n]
 EndeavourOS Nvidia Installer v2.1
 optional arguments:
   -h, --help       show this help message and exit
   -b, --bumblebee  For Nvidia Optimus cards (Bumblebee + proprietary Nvidia drivers)
   -f, --force      Force driver installation even if a nvidia card is not detected
   -t, --test       Test mode. Nothing in your system will be modified
   -q, --quiet      Supress log messages
   -n, --nouveau    Restores nouveau (open) nvidia driver

Install Nvidia proprietary drivers

test run for installation (will do i dry run without any changes to the system)

nvidia-installer-dkms -t

if it does not put out error run real install:

sudo nvidia-installer-dkms

this will install Nvidia proprietary drivers and do some configuration inside /etc/X11/xorg.conf.d/

sudo systemctl reboot

And you are on Nvidia drivers!

If you want KMS (no requirement)

to get maybe want gnome-wayland-session working you need to hack a bit after this…

adding nvidia-drm.modeset=1 to the kernel parameter inside grub:

sudo nano /etc/default/grub

and put nvidia-drm.modeset=1 inside as you can see here:

# GRUB boot loader configuration



GRUB_CMDLINE_LINUX_DEFAULT="nvidia-drm.modeset=1 resume=UUID=*****

save the file [Ctrl+X] and rebuild the grub.cfg:

sudo grub-mkconfig -o /boot/grub/grub.cfg

edit mkinitcpio.conf to get the module inside:

sudo nano /etc/mkinitcpio.conf

and edit like this:

# vim:set ft=sh


# The following modules are loaded before any boot hooks are

# run. Advanced users may wish to specify all system modules

# in this array. For instance:

# MODULES="piix ide_disk reiserfs"



save the file as above…

rebuild kernel image:

sudo mkinitcpio -p linux

replace linux with linux-lts if you are using lts kernel….

reboot again and you should have early boot enabled…

this will make it possible to run a GNOME session on wayland together with GDM instead of lightdm…

Avoid screen tearing

and i have nvidia-settings installed and run it on login with this to get better video quality:

nvidia-settings --assign CurrentMetaMode="nvidia-auto-select +0+0 { ForceFullCompositionPipeline = On }"


You can add this to /etc/X11/xorg.conf.d/20-nvidia.conf like this:

Section "Device"
    Identifier "Nvidia Card"
    Driver "nvidia"
    VendorName "NVIDIA Corporation"
    Option "NoLogo" "true"

Section "Screen"
        Identifier      "nvidia"
        Option         "metamodes" "nvidia-auto-select +0+0 { ForceFullCompositionPipeline = On }"

        Option          "TripleBuffer"                  "on"
        Option          "AllowIndirectGLXProtocol"      "off"


is also possible to install with this little helper:

sudo nvidia-installer -b

This will look like this:

nvidia-installer -b
2017-12-17 17:02:29 [INFO]: EndeavourOS Nvidia Installer v2.1
2017-12-17 17:02:29 [INFO]: All logs will be stored in /tmp/nvidia-installer.log
2017-12-17 17:02:29 [INFO]: Installing bumblebee driver...
2017-12-17 17:02:29 [INFO]: Removing conflicting packages...
2017-12-17 17:02:29 [INFO]: Downloading and installing driver packages, please wait...
2017-12-17 17:04:43 [INFO]: Adding user username to bumblebee group...
2017-12-17 17:04:43 [INFO]: gpasswd -a username bumblebee
2017-12-17 17:04:43 [INFO]: Adding user username to video group...
2017-12-17 17:04:43 [INFO]: gpasswd -a username video
2017-12-17 17:04:43 [INFO]: Enabling bumblebeed.service service...
2017-12-17 17:04:43 [INFO]: systemctl enable bumblebeed.service
2017-12-17 17:04:43 [INFO]: Patching /usr/share/applications/nvidia-settings.desktop...
2017-12-17 17:04:43 [INFO]: /etc/X11/xorg.conf.d/20-nvidia.conf not found. That's ok.
2017-12-17 17:04:43 [INFO]: Installation finished. You need to reboot now!

Nvidia Optimus

by community member Wimmetje

For who?

This guide is pure for hybrid graphics laptops with Intel/Nvidia graphics cards, so no need for installing it on desktops. The Nvidia-installer with comes with EOS is just fine to use and works with no problem with the Bumblebee service to switch between Intel en Nvidia graphics. So you can save some battery when mobile

So why use Optimus Manager instead of Bumblebee?

Optimus manager has the same functionality as Bumblebee, (despite the technical differences) it allows you to switch between Intel and Nvidia graphics on hybrid laptops. The difference is that Optimus Manager has better performance for gaming and has support for the Vulkan drivers so you can properly game with the latest games on Linux (Lutris, Steam, Wine)

First step

Endeavour OS has its own Nvidia-installer script that is ported from Antergos, with this script you can get the latest Nvidia proprietary drivers and the Bumblebee option to switch between Intel and Nvidia.
This install script with the Bumblebee is necessary to get the Nvidia driver working next to the Intel graphics.

Run in Terminal

nvidia-installer -b

(-b is bumblebee option)


After reboot check the Nvidia-settings in the Menu launcher or via Terminal:


If correct it will be showing the driver version and all the Nvidia graphics information.

At this point you got the Nvidia driver installed with the bumblebee option, so basically you can switch between the two graphics cards.
The only downside is that Bumblebee is lacking in performance and doesn’t support Vulkan drivers to proper run games with Wine, Lutris, Steam etc.

Second step

Now we are going to install Optimus Manager and disable Bumblebee so there is no interference.
Optimus Manager has basically the same function as Bumblebee but does it with better performance and Vulkan support.

Run in Terminal:

yay optimus-manager-qt

(this will install the Optimus Manager + Tray application to easy switch between Intel/Nvidia)

Don’t reboot

sudo systemctl disable bumblebeed.service

(By this we disabled the bumblebee daemon)

  1. Go to /etc/X11/xorg.conf.d/ and disable any graphic related configs. Instead of deleting them, just rename them by adding .bak. (Possible that there aren’t any related files, so you can go to the next step)
  2. Go to /etc/X11/ and disable any related graphics configs (The same situation as above, Probably there isn’t any related files, so you can get to the next step)
  3. Reboot
  4. After the reboot open Optimus Manager via the Menu launcher, a tray icon will appear with the “Intel” logo in it. Richt-click, go in settings and check “Launch at startup”.
  5. In Terminal:

systemctl status optimus-manager.service

check if it runs correctly and with no errors

  1. Now switch to Nvidia GPU, right-click on the Tray and select “Switch to Nvidia “
  2. After login again, type in the terminal


If correct it will be showing the driver version and all the Nvidia graphics information.

Here it is, you installed the Nvidia drivers with all the potential unlocked.
After this, you can install all the supported Vulkan drivers and play games with Wine, Lutris and Steam with full performance.


If you have trouble booting into the graphical system on bumblebee you can blacklist Nvidia and nouveau drivers from grub kernel boot line:

adding modprobe.blacklist=nouveau if you do not have nvidia drivers installed, so it will boot with intel GPU only.

adding both: modprobe.blacklist=nouveau modprobe.blacklist=nvidia if you have nvidia drivers installed, as it may load nouveau-driver from kernel (if not already blacklisted).

Simple press “e” (for edit) when you reach grub boot menu:

  • Use the arrow keys to find the line looks like this: linux /vmlinuz=linux root=UUID=…… rw quiet resume=…. (… = long snake of numbers)
  • put systemd.unit=multi-user.target right after rw like this: rw modprobe.blacklist=nouveau modprobe.blacklist=nvidia resume=....
  • Press Ctrl+X to boot with this parameter.

For EFI/UEFI boot:

press e use right arrow key to reach the end of the line and add parameter at the end press enter to boot.

Follow us
Was this article helpful to you? Yes 6 No 4

How can we help?