Skip to main content

Managing Repositories

The plugin matches your project's Git remotes to GitLab repositories and adds what it finds to the scope dropdown. Use the Manage Repositories dialog when discovery misses a repository, or to control which repositories are tracked.

Opening the Manage Repositories Dialog​

Click the Manage Repositories in the Choose Scope popup in the GitLab Merge Requests tool window, 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. Authenticate when prompted.
  4. A search popup appears. Type at least 3 characters to search for projects.
  5. Select the repository to add and click OK.

Configuring VCS Mappings​

A VCS mapping associates a remote repository with a local Git root. Features such as Jump to Source and branch checkout need one, and where a mapping exists the plugin reads data such as file diffs from local Git instead of the server, which is faster.

The plugin fills the VCS Root and VCS Remote columns automatically. Adjust them in the table when a repository is matched to the wrong root or remote.

Repository Groups​

Repositories belong either to the Project group, stored in project settings, or to a named group that is IDE-wide and persists across projects. Use the group dropdown at the top of the dialog to create, rename, copy, or delete named groups.

Other Actions​

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

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