DBeaver Documentation

DOWNLOAD pdf

Troubleshooting system issues

Table of contents

DBeaver is an Eclipse RCP application, so it may encounter issues with GTK or certain Linux desktop environments. Below are common problems and their solutions:

Screen flickering

To fix screen flickering, add this line to your ~/.profile file:

export GTK_IM_MODULE=ibus

Mixed dark and light theme elements

If parts of DBeaver show a mix of light and dark colors when using a system theme, switch to a theme that matches your system’s color palette.

Missing browser functionality

If you see an error like No more handles because there is no underlying browser available, install the libwebkit2gtk library.

Theme parsing errors

If you get errors like GTK-WARNING xxx:Theme parsing error, try adjusting the GTK program style in your system settings:

  • Open System Settings -> Appearance -> Program Style (the exact location may vary by desktop environment).

  • Pick a style that works better with GTK apps.

Gtk box gadget distribute error

If you see the error gtk_box_gadget_distribute: assertion size 'size >= 0' failed in GtkScrollbar, turn off GTK overlay scrolling:

  1. Open the file ~/.config/gtk-3.0/settings.ini.
  2. Add or update this setting:
    [Settings]  
gtk-overlay-scrolling = false

Disabling the AT SPI accessibility bridge

The AT-SPI accessibility bridge can sometimes cause crashes, especially on Linux with Cinnamon. To disable it:

  1. Open a terminal and run:

    export NO_AT_BRIDGE=1

  2. Make the change permanent:

    • Add the line to your shell configuration file (e.g., ~/.bashrc or ~/.zshrc):
      export NO_AT_BRIDGE=1

  3. Restart your session to apply the change.