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¶
- Open File -> Switch workspace.
- Select a workspace from the list (If you have already switched your workspace previously), or click Other....
- In the dialog, choose or enter a new workspace path.
- 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:
Git integration¶
Use DBeaver's Git integration to save and sync your projects, scripts, and settings. For more details, see Project team work.