You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+34-4Lines changed: 34 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,6 +60,8 @@ The application can be accessed at:
60
60
61
61
*https://yourhost:3001/
62
62
63
+
**Note: This is the Desktop application in a web accessible format! This container is for running the client in a sandbox so it does not have access to your system. It is not a server solution!**
64
+
63
65
### Strict reverse proxies
64
66
65
67
This image uses a self-signed certificate by default. This naturally means the scheme is `https`.
@@ -104,7 +106,9 @@ To use hardware acceleration in Wayland mode, we distinguish between the card us
104
106
*`DRINODE`: The path to the GPU used for **Rendering** (EGL).
105
107
*`DRI_NODE`: The path to the GPU used for **Encoding** (VAAPI/NVENC).
106
108
107
-
If both variables point to the same device, the container will automatically enable **Zero Copy** encoding, significantly reducing CPU usage and latency.
109
+
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.
110
+
111
+
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**.
108
112
109
113
##### Intel & AMD (Open Source Drivers)
110
114
@@ -122,13 +126,34 @@ For Intel and AMD GPUs.
122
126
123
127
##### Nvidia (Proprietary Drivers)
124
128
129
+
**Note: Nvidia support is currently considered experimental, driver changes can break it at any time.**
130
+
125
131
**Note: Nvidia support is not available for Alpine-based images.**
126
132
133
+
**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**
134
+
127
135
**Prerequisites:**
128
136
129
-
1. **Driver:** Proprietary drivers **580 or higher** are required.
130
-
2. **Kernel Parameter:** Set `nvidia-drm.modeset=1` in your host bootloader (GRUB/systemd-boot).
131
-
3. **Initialization:** On headless systems, run `nvidia-modprobe --modeset` on the host (once per boot) to initialize the card.
137
+
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.**
138
+
* **Unraid:** Use the production branch from the Nvidia Driver Plugin.
139
+
140
+
2. **Kernel Parameter:** You must set `nvidia-drm.modeset=1 nvidia_drm.fbdev=1` in your host bootloader.
141
+
* **Standard Linux (GRUB):** Edit `/etc/default/grub` and add the parameter to your existing `GRUB_CMDLINE_LINUX_DEFAULT` line:
* **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.
154
+
155
+
3. **Hardware Initialization:** **On headless systems, the Nvidia video card requires a physical dummy plug inserted into the GPU so that DRM initializes properly.**
156
+
132
157
4. **Docker Runtime:** Configure the host docker daemon to use the Nvidia runtime:
133
158
134
159
```bash
@@ -157,6 +182,8 @@ services:
157
182
capabilities: [compute,video,graphics,utility]
158
183
```
159
184
185
+
* **Unraid:** Ensure you're properly setting the DRINODE/DRI_NODE and adding `--gpus all --runtime nvidia` to your extra parameters.
186
+
160
187
### SealSkin Compatibility
161
188
162
189
This container is compatible with [SealSkin](https://sealskin.app).
@@ -177,12 +204,14 @@ This container is based on [Docker Baseimage Selkies](https://github.com/linuxse
177
204
| Variable | Description |
178
205
| :----: | --- |
179
206
| PIXELFLUX_WAYLAND | **Experimental** If set to true the container will initialize in Wayland mode running [Smithay](https://github.com/Smithay/smithay) and Labwc while enabling zero copy encoding with a GPU |
207
+
| SELKIES_DESKTOP | If set to true and in Wayland mode, a simple panel will be initialized with labwc |
180
208
| CUSTOM_PORT | Internal port the container listens on for http if it needs to be swapped from the default `3000` |
181
209
| CUSTOM_HTTPS_PORT | Internal port the container listens on for https if it needs to be swapped from the default `3001` |
182
210
| CUSTOM_WS_PORT | Internal port the container listens on for websockets if it needs to be swapped from the default 8082 |
| DRI_NODE | **Encoding GPU**: Enable VAAPI/NVENC stream encoding and use the specified device IE `/dev/dri/renderD128` |
185
213
| DRINODE | **Rendering GPU**: Specify which GPU to use for EGL/3D acceleration IE `/dev/dri/renderD129` |
214
+
| 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` |
186
215
| PASSWORD | HTTP Basic auth password, abc is default. If unset there will be no auth |
187
216
| SUBFOLDER | Subfolder for the application if running a subfolder reverse proxy, need both slashes IE `/subfolder/` |
188
217
| TITLE | The page title displayed on the web browser, default "Selkies" |
@@ -612,6 +641,7 @@ Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64
612
641
613
642
## Versions
614
643
644
+
* **04.04.26:** - Make Wayland default disable with PIXELFLUX_WAYLAND=false.
615
645
* **28.12.25:** - Add Wayland init logic.
616
646
* **22.09.25:** - Rebase to Debian Trixie.
617
647
* **12.07.25:** - Rebase to Selkies, HTTPS IS NOW REQUIRED.
Copy file name to clipboardExpand all lines: readme-vars.yml
+4Lines changed: 4 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -35,6 +35,9 @@ app_setup_block: |
35
35
The application can be accessed at:
36
36
37
37
* https://yourhost:3001/
38
+
39
+
**Note: This is the Desktop application in a web accessible format! This container is for running the client in a sandbox so it does not have access to your system. It is not a server solution!**
40
+
38
41
# init diagram
39
42
init_diagram: |
40
43
"rustdesk:latest": {
@@ -107,6 +110,7 @@ init_diagram: |
107
110
"rustdesk:latest" <- Base Images
108
111
# changelog
109
112
changelogs:
113
+
- {date: "04.04.26:", desc: "Make Wayland default disable with PIXELFLUX_WAYLAND=false."}
0 commit comments