Skip to content


This article here will get removed soon and is not working anymore

the old nvidia-installer-dkms is replaced with a rewritten new tool nvidia-inst go here please:

by joekamprad

We do offer a script that was developed for Antergos by karasu and we forked it to use it for EndeavourOS.

nvidia-installer-dkms can be used easily to install and remove proprietary Nvidia drivers.

The package is available from EndeavourOS Repository to install it:

sudo pacman -S nvidia-installer-dkms

We ship the dkms version by default so the drivers can be kept up-to-date, regardless of the kernel version you’re using. Using the dkms version also means, you need to install the kernel header packages that match to your installed kernel(s).If you are using our AKM tool, the headers will be installed by default.

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

The Nvidia-installer includes a tool nvidia-installer-check that can be used for checking which of the Nvidia-driver version is supported by your NVidia graphics card. Here are some examples of its output:

$ nvidia-installer-check 
Your graphics card (id 1dba) is supported by the nvidia-dkms driver.

$ nvidia-installer-check 
Your graphics card (id 06c4) is supported by the nvidia-390xx-dkms driver.
Use the --force option with nvidia-installer-dkms.
Then, BEFORE rebooting, install nvidia-390xx-dkms from the AUR, for example:
  yay -S nvidia-390xx-dkms

$ nvidia-installer-check 
Sorry, your Nvidia card (id: aaaa) is not supported by nvidia-dkms nor nvidia-390xx-dkms.

More info on dkms:

Workaround for NVidia cards that require 390xx series driver

  • Use nvidia-installer-dkms to install nvidia-dkms (may need to use the --force option)
  • If you get a warning about card is not in our database, then, before rebooting, install nvidia-390xx-dkms from the AUR:

yay -S nvidia-390xx-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 (It will perform a dry run without making any changes to the system)

nvidia-installer-dkms -t

When there are no errors reported, then run:

sudo nvidia-installer-dkms

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

Then run:

sudo systemctl reboot

And you are running Nvidia drivers!

Bumblebee for older Nvidia-Intel Optimus notebooks:

If you need to set up Bumblebee as detailed here: EndeavourOS Bumblebee wiki the nvidia-installer script can do that automatically too:

sudo nvidia-installer-dkms -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!

Workaround in case Xorg fails to load on DE sessions

and Optimus hybrid graphics Notebooks:

Remove the file:


It is not needed per default as Xorg will use default detected settings automatically in most cases.

This can also affect systems using Wayland sessions like GNOME or Plasma and sway.

As Wayland uses settings it takes over from Xorg in cases.

You may need the nvidia Xorg file to enable some features for the Nvidia GPU Driver like:


All Nvidia entries:

Connect with us:

EndeavourOS Nvidia Installer

  • by
%d bloggers like this: