Skip to content

Commit 595d6f0

Browse files
authored
Merge pull request #388 from linuxserver/more-nvidia-tweaks
mention chromium client changes needed for nvidia frames on clients, add auto_gpu
2 parents 570366c + 4dca461 commit 595d6f0

File tree

1 file changed

+9
-4
lines changed
  • ansible/roles/documentation/templates/README_SNIPPETS

1 file changed

+9
-4
lines changed

ansible/roles/documentation/templates/README_SNIPPETS/SELKIES.j2

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
| CUSTOM_USER | HTTP Basic auth username, abc is default. |
1010
| DRI_NODE | **Encoding GPU**: Enable VAAPI/NVENC stream encoding and use the specified device IE `/dev/dri/renderD128` |
1111
| DRINODE | **Rendering GPU**: Specify which GPU to use for EGL/3D acceleration IE `/dev/dri/renderD129` |
12+
| AUTO_GPU | If set to true and in Wayland mode, we will automatically use the first GPU available for encoding and rendering IE `/dev/dri/renderD128` |
1213
| PASSWORD | HTTP Basic auth password, abc is default. If unset there will be no auth |
1314
| SUBFOLDER | Subfolder for the application if running a subfolder reverse proxy, need both slashes IE `/subfolder/` |
1415
| TITLE | The page title displayed on the web browser, default "Selkies" |
@@ -196,7 +197,9 @@ To use hardware acceleration in Wayland mode, we distinguish between the card us
196197
* `DRINODE`: The path to the GPU used for **Rendering** (EGL).
197198
* `DRI_NODE`: The path to the GPU used for **Encoding** (VAAPI/NVENC).
198199

199-
If both variables point to the same device, the container will automatically enable **Zero Copy** encoding, significantly reducing CPU usage and latency.
200+
If both variables point to the same device, the container will automatically enable **Zero Copy** encoding, significantly reducing CPU usage and latency. If they are set to different devices one will be used for **Rendering** and one for **Encoding** with a cpu readback.
201+
202+
You can also use the environment variable `AUTO_GPU=true`, with this set the first card detected in the container (IE `/dev/dri/renderD128`) will be used and configured for **Zero Copy**.
200203

201204
##### Intel & AMD (Open Source Drivers)
202205

@@ -219,16 +222,18 @@ For Intel and AMD GPUs.
219222

220223
**Note: Nvidia support is not available for Alpine-based images.**
221224

225+
**Note: Nvidia frames have issues with hardware decoders in Chromium browsers you need to navigate to `chrome://flags/#disable-accelerated-video-decode` and toggle it to `Disabled` for smooth playback**
226+
222227
**Prerequisites:**
223228

224229
1. **Driver:** Proprietary drivers **580 or higher** are required. **Crucially, you should install the driver using the `.run` file downloaded directly from the Nvidia website.**
225230
* **Unraid:** Use the production branch from the Nvidia Driver Plugin.
226231

227-
2. **Kernel Parameter:** You must set `nvidia-drm.modeset=1` in your host bootloader.
232+
2. **Kernel Parameter:** You must set `nvidia-drm.modeset=1 nvidia_drm.fbdev=1` in your host bootloader.
228233
* **Standard Linux (GRUB):** Edit `/etc/default/grub` and add the parameter to your existing `GRUB_CMDLINE_LINUX_DEFAULT` line:
229234

230235
```text
231-
GRUB_CMDLINE_LINUX_DEFAULT="<other existing options> nvidia-drm.modeset=1"
236+
GRUB_CMDLINE_LINUX_DEFAULT="<other existing options> nvidia-drm.modeset=1 nvidia_drm.fbdev=1"
232237
```
233238

234239
Then apply the changes by running:
@@ -237,7 +242,7 @@ For Intel and AMD GPUs.
237242
sudo update-grub
238243
```
239244

240-
* **Unraid (Syslinux):** Edit the file `/boot/syslinux/syslinux.cfg` and add `nvidia-drm.modeset=1` to the end of the `append` line for the Unraid OS boot entry.
245+
* **Unraid (Syslinux):** Edit the file `/boot/syslinux/syslinux.cfg` and add `nvidia-drm.modeset=1 nvidia_drm.fbdev=1` to the end of the `append` line for the Unraid OS boot entry.
241246

242247
3. **Hardware Initialization:** **On headless systems, the Nvidia video card requires a physical dummy plug inserted into the GPU so that DRM initializes properly.**
243248

0 commit comments

Comments
 (0)