Skip to content

GUI fails to load on Linux #759

@nwagenbrenner

Description

@nwagenbrenner

The GUI fails to load with error:

GBM is not supported with the current configuration. Fallback to Vulkan rendering in Chromium.

I'm using the master branch and Qt version 6.10.1 This may the be same issue that @latwood is seeing.

Searching online, this apparently happens on Linux systems when the Generic Buffer Management (GBM) backend—used for sharing graphics buffers between applications—cannot be initialized. This is a common behavior in recent versions of Qt WebEngine (based on Chromium) and standalone Chromium browsers, especially when running on NVIDIA hardware.

This can happen because:

  • NVIDIA Compatibility: NVIDIA's proprietary drivers historically lacked full GBM support or required specific configurations to work with Wayland.

  • Qt WebEngine Behavior: In newer versions (e.g., Qt 6.9+), Qt WebEngine attempts to use GBM to import textures. If it fails, it forces Chromium to use Vulkan as a fallback to maintain graphics interoperability.

  • Compositor Issues: The error can occur if you are running a window manager without a compositor or using an environment that doesn't support the specific rendering path the browser is requesting.

Potential Fixes and Workarounds:

  • If the fallback causes performance issues, crashes, or visual glitches (like black screens), you can try the following:

  • Disable GPU Acceleration: For some applications (like CoolerControl), launching with the --disable-gpu flag can bypass the rendering error.

  • Force Disable GBM: Set the environment variable QTWEBENGINE_FORCE_USE_GBM=0 before launching the application.

  • Switch Ozone Platform: If running on Wayland, try forcing the application to use X11 via XWayland with the flag --ozone-platform=x11.

  • Software Rendering: If Vulkan and GBM both fail, you can force software rendering using --use-gl=disabled or -s qt.force_software_rendering.

  • Check Drivers: Ensure you have the latest drivers installed. For NVIDIA, verify you have packages like nvidia-utils and lib32-nvidia-utils (on Arch-based systems) or equivalent libraries for Vulkan support.

  • Diagnostic Tool: Visit chrome://gpu in your browser to view the "Graphics Feature Status" and "Dawn Info" to see exactly which components are failing to initialize

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions