Skip to content

Workspace location

Default location of the workspace

By default, DBeaver stores all its files (configurations, scripts, diagrams, etc.) in the following folder:

OS Location
Windows %APPDATA%\DBeaverData\
MacOS ~/Library/DBeaverData/
Linux $XDG_DATA_HOME/DBeaverData/ ($XDG_DATA_HOME=~/.local/share if not set)

Folders inside DBeaverData

Folder Location
workspace6 Workspace files for DBeaver (Community, Lite, Enterprise and Ultimate).
drivers Auto downloaded database drivers.
install-data Runtime files used by different versions ofr product.
secure Global credentials (encrypted with master password).
settings Global settings (e.g. user interface language).

Switch workspace

Switch the workspace to change where DBeaver stores settings, connections, and local data.

Switch workspace

  1. Open File -> Switch workspace.
  2. Select a workspace from the list (If you have already switched your workspace previously), or click Other....
  3. In the dialog, choose or enter a new workspace path.
  4. Click Launch.

Copy settings

When switching, you can copy settings to the new workspace:

  • Workbench layout - opened views, layout, and perspectives
  • Preferences - UI behavior, and editors configuration

Custom location

You can specify a custom workspace location by passing parameter -data <path> in the command line. <path> can be an absolute or relative directory path.

Use environment variables

You can use environment variables to set custom locations:

  • DBEAVER_WORKSPACE sets the workspace path to its non-empty value. If the variable is unset or empty, DBeaver uses the default workspace location.
  • DBEAVER_DATA sets the DBeaverData folder location. For a non-empty value, DBeaver uses the DBeaverData folder at that location. If the variable is unset or empty, DBeaver uses the default location for your operating system.

When both variables are set, DBEAVER_WORKSPACE sets the workspace path, and DBEAVER_DATA sets the DBeaverData folder location.

Old default workspace location

Old - means before DBeaver 6.1.3

OS Location
Windows C:\Users\YourName\.dbeaver4.
Linux ~/.dbeaver4/
MacOS ~/.dbeaver4/

Ancient default workspace location

Ancient - means before DBeaver 4.

OS Location
Windows C:\Users\YourName\.dbeaver.
Linux ~/.dbeaver/
MacOS ~/.dbeaver/

Migrating workspace

To transfer everything, including configurations, projects, scripts, diagrams, and other workspace data, copy the entire workspace folder and place it in the corresponding location on the new machine.

Alternatively, you can export and import specific items like Projects, Scripts, or Preferences separately, or use Git integration to manage and sync your work:

Export and import

To transfer specific items like Projects, Scripts, or Preferences, use DBeaver's export and import functionality.

For detailed steps on exporting and importing, see:

Git integration

Use DBeaver's Git integration to save and sync your projects, scripts, and settings. For more details, see Project team work.