Skip to content

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

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

    Fields

    No fields configured for Bug.

    Projects

    Status
    On Hold

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions