$ the-wire · showcase
Open WebUI Desktop fixes blank Linux webviews, decouples local server
By RepoJournal · Filed · About Open WebUI
Open WebUI Desktop 0.0.19 ships with a critical Linux fix that restores blank webviews by replacing --in-process-gpu with SwiftShader.
Open WebUI Desktop is releasing 0.0.19 [1] alongside a refactor [2] that reshapes how the app manages the local server. The release bundles the new architecture and the Linux fix. The refactor decouples the local server from the connections array: local is now a virtual connection ID, synthesized only when the open-webui package is installed, and connections[] is strictly remote. Previously, the local server was modeled as a type:'local' entry, which was only created during the Get Started flow, breaking installs from Settings. [2]
Two platform-specific fixes are in development. On Linux, the --in-process-gpu flag broke <webview> guest compositing, leaving connection views blank. The fix replaces it with SwiftShader (--use-gl=angle --use-angle=swiftshader), which keeps the GPU process out-of-process (required for webview compositing) while using software rendering to avoid the driver-level /dev/shm crashes. [3] On macOS, Spotlight no longer drags the app to its original Space: app.focus({ steal: true }) activates the whole app, so the fix uses targeted window-level focus with visibleOnAllWorkspaces. [4]
Maintainer Timothy Jaeryang Baek notes the in-process GPU flag "broke <webview> guest compositing entirely," which is the root cause users saw as blank connection views on every Linux configuration. [3]
Action items
- → Update to Desktop 0.0.19 to get the Linux blank-webview fix and the local-server refactor open-webui/desktop [immediate]
- → Watch the SwiftShader fix [ref:3] and the macOS Spotlight fix [ref:5]; both target Linux and macOS respectively, with no test coverage mentioned open-webui/desktop [monitor]
References
- [1] 0.0.19 ↗ open-webui/desktop
- [2] refac ↗ open-webui/desktop
- [3] fix: replace --in-process-gpu with SwiftShader to fix blank webviews on Linux ↗ open-webui/desktop
- [4] fix: prevent Spotlight from pulling to first desktop on macOS Spaces (#179) ↗ open-webui/desktop