Workspace Location

Table of contents

• Default location of the workspace
  • Folders inside DBeaverData
• Switch workspace
  • Switch workspace
  • Copy settings
• Custom location
• Old default workspace location
• Ancient default workspace location
• Migrating workspace
  • Export and import
  • Git integration

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.

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:

• Projects
• Scripts
• Preferences

Git integration

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