surrealist: Bug: blank screen on database connect after OS update

Describe the bug

surrealist runs normally till i try to connect to my server. the screen goes blank and the console stops outputing

Steps to reproduce

im on linux mint fresh out of the box im using WEBKIT_DISABLE_DMABUF_RENDERER=1 surrealist to run it

Expected behaviour

i connect to my database and surrealist stops responding to my mouse and clicks and after some time it goes blank

the console output is https://pastebin.com/BUSEv10T

Surrealist Environment

surrealist v3.0.0-beta.2 or v2.1.6 (these are the ones i tried)

Additional info

this bug started to occur after a linux mint update

About this issue

  • Original URL
  • State: closed
  • Created 2 years ago
  • Reactions: 1
  • Comments: 41 (6 by maintainers)

Most upvoted comments

Hello everyone! I know this has been a frustrating problem for all of you, and while I do not bring a solution yet, I do have some findings to report.

After extensive testing on Windows through WSL 2 Running Ubuntu 22.04 I have been able to successfully reproduce the crash. I was able to narrow down the cause of this issue to the WebAssembly used by Surrealist, which includes the surrealdb runtime (@surrealdb/wasm) and the SurrealQL support package (@surrealdb/ql-wasm).

Executing this WebAssembly code causes the browser process used by Surrealist (webkit2gtk) to freeze and crash entirely. This is caused by a recent issue in libwebkit2gtk-4.1 which made it to the live package. Unfortunately at this time it does not appear a solution is available yet.

I hope this gives some context and perspective on the issue at hand, and while we cannot solve it at this time as it is technically caused by an issue external to Surrealist, I will continue to closely monitor and report back on any updates.

Thank you all for your patience!

After testing myself I can indeed confirm the latest version of libwebkit2gtk is working and Surrealist is once again compatible. 🎉

For those looking to resolve this issue, simply upgrade your packages and the current installed version of Surrealist should work again.

sudo apt update && sudo apt upgrade

If some people here can’t get it to work with different versions try AppImage “Surrealist v3.0.0-beta.1”, it works for me right now as a workaround. I’m on Ubuntu 24.04.1 LTS , Gnome 46. It works both on X11 and Wayland.

Hey everyone, we certainly noticed the significance of this issue and are continuing to look for a solution. We cannot reproduce this issue internally with the devices to our disposal, which has not made it trivial to debug. Additionally the circumstances causing this issue appear to vary greatly, making it additionally difficult to pin down. What we do know is that it only affects Linux devices.

To move things forward I have some additional questions I would like to gather feedback on.

  • Please try opening the developer tools panel, for which an explanation can be found here. This may lead to further details as to what causes this issue, especially within the Console tab.
  • Does this only affects the desktop app or also the web app? Is this consistent across different browsers?
  • Does backing up and deleting the config file ($HOME/.config/SurrealDB/Surrealist/config.json) solve the issue?
  • Is there a reproducible way to trigger the blank screen?

Hopefully additional insight might lead us closer to the root cause so we can fix this. Thank you all for your help and patience!

Surrealist seems to be working as expected now, after I installed an update in the libwebkit2gtk-4.1-0 library for Ubuntu 24.04.

Can somebody else confirm if sudo apt update && sudo apt upgrade fixed this error for them?

This is the same problem over and over again, and it is unlikely that anyone will be able to solve it because: https://github.com/surrealdb/surrealist/issues/424#issuecomment-2407484597

Same issue on Linux mint with any version past 3.0.0. To put salt in the wound, rolling back to older releases stopped working after I opened the new version once. The versions that worked before now do not work even after clearing cache and reinstall (I did not update the OS in the meantime).

Related: https://github.com/surrealdb/surrealist/issues/492, but then I got stuck here too.

I also get this in Surrealist desktop, first the white screen and afterwards this crash:

Screenshot part 1 Screenshot part 2

OS: Ubuntu 24.04.1 LTS

Version: 3.0.3 Flags: feature_flags: false, query_view: true, explorer_view: true, graphql_view: true, designer_view: true, auth_view: true, functions_view: true, models_view: true, apidocs_view: true, cloud_view: true, themes: true, newsfeed: true, database_version_check: true, highlight_tool: false, legacy_serve: false, cloud_endpoints: production, cloud_access: false, cloud_killswitch: true, changelog: auto

P.S. I have updated the distribution like it recommends at the bottom, but still, same error

  1. Nothing happens opening the developer console
  2. Desktop app
  3. Deleting config.json shows me the initial screen again, but then it freezes for example adding a new connection or opening the Sandbox.
  4. I don’t know how to reproduce the error