Skip to content

[Linux] WebRTC Stream Fails on NVIDIA/WebKitGTK (Dev Environment) #1

@Levy-Y

Description

@Levy-Y

Description

Video streaming (KVS WebRTC) fails to initialize on Linux development machines running Ubuntu 24.04 with proprietary NVIDIA drivers (535/550/580).

Root Cause

WebKitGTK crashes or silently disables the RTCPeerConnection API due to a conflict with GStreamer hardware acceleration (DMABUF / GST_GL) on NVIDIA cards.

  • Attempts to force software rendering via environment variables (WEBKIT_DISABLE_DMABUF_RENDERER=1) yielded inconsistent results.
  • Code logic is confirmed 100% functional on Android/Chromium targets.

Current Workaround

A try-catch block has been implemented in CameraDialog.tsx to detect this specific environment failure.

  • Behavior: Instead of crashing or hanging, the UI displays a 'WebRTC Disabled (Linux/NVIDIA)' placeholder.
  • Action: No further fix is planned for the Linux desktop client unless it becomes a primary target platform. This is a known local dev limitation.

Logs

Error observed: RTCPeerConnection is not supported in this environment.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingplatform:linuxwontfixThis will not be worked on

    Type

    Projects

    Status

    On Hold

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions