Title
Bug in UI at DPI parameter; missing parameters enable-gfx: false, color-depth: 16; black screen on any RDP connection
Platform
Website - Chrome
Server Installation Method
Docker
Version
2.2.0
Troubleshooting
The Problem
Title: RDP connections result in black screen - missing GFX parameters and DPI bug
Describe the bug:
RDP connections through Termix always result in a black screen. After extensive debugging, two issues were identified:
Issue 1: DPI parameter bug
The guacd logs show the following warning on every RDP connection:
WARNING: Specified value "96?undefined" for parameter "dpi" is not valid. Using default value of 96.
The UI is sending 96?undefined instead of 96 for the DPI parameter. This suggests a frontend concatenation bug where an undefined variable is being appended to the DPI value.
Issue 2: Missing RDP display parameters
The connectionDefaultSettings in guacamole-server.ts is missing parameters to disable GFX/RemoteFX pipeline, which is required for compatibility with modern Windows 10 and Windows Server 2022.
The guacd logs show the connection reaches RDPDR but then disconnects silently:
Connected to RDPDR 1.13 as client 0x0005
Internal RDP client disconnected
Suggested fix:
Add the following to connectionDefaultSettings.rdp in guacamole-server.ts:
typescript"color-depth": 16,
"enable-gfx": false,
"enable-gfx-h264": false,
"enable-audio-input": false,
Environment:
Termix version: latest (2.2.0)
guacd version: guacamole/guacd:latest (1.6.0) with default and custom build with FreeRDP 3.5
Windows versions tested: Windows 10, Windows Server 2022
Host OS: Ubuntu 22.04
Expected behavior:
RDP connection should display the remote desktop.
Actual behavior:
Black screen / immediate disconnection after RDPDR handshake.
How to Reproduce
RDP on any windows
Additional Context
No response
Title
Bug in UI at DPI parameter; missing parameters enable-gfx: false, color-depth: 16; black screen on any RDP connection
Platform
Website - Chrome
Server Installation Method
Docker
Version
2.2.0
Troubleshooting
The Problem
Title: RDP connections result in black screen - missing GFX parameters and DPI bug
Describe the bug:
RDP connections through Termix always result in a black screen. After extensive debugging, two issues were identified:
Issue 1: DPI parameter bug
The guacd logs show the following warning on every RDP connection:
WARNING: Specified value "96?undefined" for parameter "dpi" is not valid. Using default value of 96.
The UI is sending 96?undefined instead of 96 for the DPI parameter. This suggests a frontend concatenation bug where an undefined variable is being appended to the DPI value.
Issue 2: Missing RDP display parameters
The connectionDefaultSettings in guacamole-server.ts is missing parameters to disable GFX/RemoteFX pipeline, which is required for compatibility with modern Windows 10 and Windows Server 2022.
The guacd logs show the connection reaches RDPDR but then disconnects silently:
Connected to RDPDR 1.13 as client 0x0005
Internal RDP client disconnected
Suggested fix:
Add the following to connectionDefaultSettings.rdp in guacamole-server.ts:
typescript"color-depth": 16,
"enable-gfx": false,
"enable-gfx-h264": false,
"enable-audio-input": false,
Environment:
Termix version: latest (2.2.0)
guacd version: guacamole/guacd:latest (1.6.0) with default and custom build with FreeRDP 3.5
Windows versions tested: Windows 10, Windows Server 2022
Host OS: Ubuntu 22.04
Expected behavior:
RDP connection should display the remote desktop.
Actual behavior:
Black screen / immediate disconnection after RDPDR handshake.
How to Reproduce
RDP on any windows
Additional Context
No response