Skip to content

Commit

Permalink
chore: update nvidia docs
Browse files Browse the repository at this point in the history
  • Loading branch information
@mirkobrombin
mirkobrombin committed Aug 5, 2024
1 parent 3fee296 commit fe3f331
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 45 deletions.
4 changes: 1 addition & 3 deletions articles/en/install-additional-drivers.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,7 @@ Nvidia drivers are detected and installed automatically in Vanilla OS during the
abroot config-editor
```

here change the `name` parameter to `vanilla-os/nvidia` for recent Nvidia GPUs (e.g. GTX 600 series/RTX and newer) or `vanilla-os/nvidia-propietary` for older Nvidia GPUs (e.g. GTX 400 and 500 series) and save the file.

> Note: both images works with recent images, but the `vanilla-os/nvidia` is the one that should work with most recent GPUs.
here change the `name` parameter to `vanilla-os/nvidia` and save the file.

Then run:

Expand Down
78 changes: 36 additions & 42 deletions articles/en/nvidia-issues.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ If you have an NVIDIA GPU, you should see an output similar to this:

```bash
+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 555.42.06 Driver Version: 555.42.06 CUDA Version: N/A |
| NVIDIA-SMI 535.183.01 Driver Version: 535.183.01 CUDA Version: N/A |
|-----------------------------------------+------------------------+----------------------+
| GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. |
Expand All @@ -44,7 +44,7 @@ If you have an NVIDIA GPU, you should see an output similar to this:
+-----------------------------------------------------------------------------------------+
```

in this case, the GPU is an NVIDIA GeForce RTX 4050 and it's working fine using the `555.42.06` driver.
in this case, the GPU is an NVIDIA GeForce RTX 4050 and it's working fine using the `535.183.01` driver.

If you don't have a working NVIDIA GPU, you can still check the model by running the following command:

Expand Down Expand Up @@ -90,78 +90,72 @@ If you want to force the NVIDIA GPU for the whole system, you can do so by openi

If you installed Vanilla OS without opting for the NVIDIA drivers, you can install them later by following [this](https://docs.vanillaos.org/handbook/en/install-additional-drivers#nvidia%C2%AE-drivers) guide.

### Second monitor not working
### Freezing at boot logo or Mouse cursor lagging

If you have a second monitor connected to your NVIDIA GPU and it's not working, you are probably using the wrong system image. To check the system image you are using, run the following command:
If your system is freezing at the boot logo, you might be using the wrong system image, look at the previous section to check if you are using the correct system image and change it if needed.

If the issue persists, double check your kernel flags, by issuing the following command:

```
abroot status
abroot kargs show
```

and check the parameter `Image` under the **ABImage** section, it should be `ghcr.io/vanilla-os/nvidia` for recent NVIDIA GPUs (e.g. GTX 600 series/RTX and newer) or `ghcr.io/vanilla-os/nvidia-propietary` for older NVIDIA GPUs (e.g. GTX 400 and 500 series).

If you are not using the correct system image, you can change it by issuing the following command:
they should be similar to the following:

```
abroot config-editor
quiet splash bgrt_disable $vt_handoff nvidia-drm.modeset=1
```

then change the `tag` parameter to `main` and the `name` parameter to `ghcr.io/vanilla-os/nvidia` or `ghcr.io/vanilla-os/nvidia-propietary` depending on your GPU as mentioned above. Then save the changes and run a system update by issuing the following command:
remove the `nvidia-drm.modeset=1` flag by issuing the following command:

```
abroot upgrade -f
abroot kargs edit
```

restart your system once the upgrade is complete.
and remove the flag, then save, wait for the changes to be applied (or apply them with `abroot upgrade -f`) and restart your system.

If the issue persists, might be a very specific issue with your GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues), we will do our best to help you.
If the issue persists, might be a very specific issue with your GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues).

### Freezing at boot logo
### Cannot select Wayland session

If your system is freezing at the boot logo, you might be using the wrong system image, look at the previous section to check if you are using the correct system image and change it if needed.
If the wayland session does not appear in the login screen, might be a very specific issue with your GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues).

If the issue persists, double check your kernel flags, by issuing the following command:
### Any other issue

```
abroot kargs show
```
If you are experiencing any other issue with your NVIDIA GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues), or ask our [https://vanillaos.org/community].

they should be similar to the following:
### My GPU is too new

```
quiet splash bgrt_disable $vt_handoff
```
If your GPU is too new and not supported by the current drivers, you can try to switch to our `nvidia-exp` image, which contains the latest drivers available, but keep in mind that this image is experimental as well the drivers it contains, so you might experience some issues and we might not be able to help you with them.

or
To switch to the `nvidia-exp` image, you can run the following command:

```
quiet splash bgrt_disable $vt_handoff lsm=integrity nvidia.NVreg_DynamicPowerManagement=0x02 nvidia.NVreg_PreserveVideoMemoryAllocations=1 nvidia.NVreg_TemporaryFilePath=/var/tmp nvidia-drm.fbdev=1
```bash
abroot config-editor
```

remove any additional flags that you might have added by using the command:
here change the `name` parameter to `vanilla-os/nvidia-exp` and save the file. Then run:

```
abroot kargs edit
```bash
abroot upgrade -f
```

then save, wait for the changes to be applied (or apply them with `abroot upgrade -f`) and restart your system.
once done, reboot your system to start using the new drivers.

If the issue persists, might be a very specific issue with your GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues).
### My GPU is too old

### Cannot select Wayland session
If your GPU is too old and not supported by the current drivers, you might want to switch to the default `desktop` image, which includes the standard Nouveau drivers, which are open-source and should work with older NVIDIA GPUs.

If you cannot select the Wayland session from the login screen, be sure that you are using the correct system image, look at the previous sections to check if you are using the correct system image and change it if needed.
To switch to the `desktop` image, you can run the following command:

Some users reported that adding the `nvidia-drm.modeset=1` kernel flag, fixed the issue, you can add it by issuing the following command:

```
abroot kargs edit
```bash
abroot config-editor
```

then add the flag at the end of the line (ensure), save, wait for the changes to be applied (or apply them with `abroot upgrade -f`) and restart your system.

If the issue persists, might be a very specific issue with your GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues).
here change the `name` parameter to `vanilla-os/desktop` and save the file. Then run:

### Any other issue
```bash
abroot upgrade -f
```

If you are experiencing any other issue with your NVIDIA GPU, please open a new issue [here](https://github.com/Vanilla-OS/nvidia-image/issues), or ask our [https://vanillaos.org/community].
once done, reboot your system to start using the new drivers.

0 comments on commit fe3f331

Please sign in to comment.