Projects

Projects in DBeaver offer a flexible way to organize and manage your database connections, scripts, diagrams, and other resources.

Projects help you organize connections, resources, and workflows. Here are some scenarios where you might want to use them:

• Separate different environments, like production, staging, and development, to avoid making accidental changes.
• Streamline collaboration by organizing shared resources when using version control systems like Git.
• Manage different credentials for the same database, such as switching between read-only and admin access easily.

• Group multiple connections, scripts, and diagrams by context, making your workspace simpler to navigate.

1. To create a project, go to the Projects view, and click Create Project button in the toolbar. This opens the Project Create Wizard.

2. Enter a name for your project in the Project name field.
3. To use the default storage location, keep Use default location selected. To choose a different directory, uncheck the box, enter a new path, or click Browse to select a folder.
4. Click Finish. The new project appears in the Projects tree.

Note: You can’t rename or delete an active project.

To delete a project, right-click its name in the Projects view and select Delete from the context menu. You’ll see a confirmation dialog:

• Confirm the deletion by clicking Yes or cancel by clicking Cancel.
• To delete the project’s files (e.g., configurations, scripts) from disk, check the Delete project contents on disk box before confirming.

Note: If you delete a project and later create a new one with the same name, it will automatically include any database connections from the deleted project.