Skip to main content

Managing Repositories

The plugin automatically discovers GitLab repositories from Git remotes configured in your project. If automatic discovery doesn't find your repository, or you want to manage which repositories are tracked, use the Manage Repositories dialog.

Automatic Discovery​

When you open the GitLab Merge Requests tool window, the plugin scans your project's Git remotes and matches them to GitLab repositories. Discovered repositories appear in the scope dropdown automatically.

Opening the Manage Repositories Dialog​

  1. Open the GitLab Merge Requests tool window.
  2. Click the Manage Repositories action in the toolbar (gear icon), or go to Settings | JetLab — GitLab | Project | Manage Repositories.

Adding a Repository​

  1. In the Manage Repositories dialog, click the + (Add) button in the toolbar.
  2. Select the GitLab instance from the popup (e.g., gitlab.com or your self-managed instance).
    • If your instance is not listed, select Other... and enter the server URL.
  3. A search popup appears. Type at least 3 characters to search for projects.
  4. Select the repository to add and click OK.

Self-Managed GitLab​

For self-managed GitLab instances that are not automatically discovered:

  1. Click + (Add) in the Manage Repositories dialog.
  2. Choose Other... from the service list.
  3. Enter the URL of your GitLab instance (e.g., https://gitlab.example.com).
  4. Authenticate when prompted.
  5. Search and select the repository.

Configuring VCS Mappings​

Each repository in the table has two configurable columns:

  • VCS Root — the local Git root associated with this repository.
  • VCS Remote — the specific Git remote URL to use (e.g., origin).

The plugin tries to match these automatically, but you can adjust them via the dropdown editors in the table.

Repository Groups​

You can organize repositories into groups:

  • Project — repositories stored in project settings (default).
  • Named groups — IDE-wide groups that persist across projects. Use the group dropdown at the top of the dialog to create, rename, copy, or delete groups.

Other Actions​

  • Remove — select a repository and click - to remove it.
  • Reset — revert to the last saved state.
  • Discover from Scratch — clear all repositories and re-run automatic discovery.
note

Saving changes in the Manage Repositories dialog will close all open merge request tabs to apply the new configuration.