Install and set up GitLab for Eclipse

Tier: Free, Premium, Ultimate Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated Status: Experiment
This page contains information related to upcoming products, features, and functionality. It is important to note that the information presented is for informational purposes only. Please do not rely on this information for purchasing or planning purposes. The development, release, and timing of any products, features, or functionality may be subject to change or delay and remain at the sole discretion of GitLab Inc.

Install the GitLab for Eclipse plugin

Prerequisites:

  • Eclipse 4.33 and later.
  • GitLab version 16.8 or later.

To install GitLab for Eclipse:

  1. Open your Eclipse IDE and your preferred web browser.
  2. In your web browser, go to the page for the GitLab for Eclipse plugin in the Eclipse Marketplace.
  3. On the plugin’s page, select Install, and drag your mouse over to your Eclipse IDE.
  4. In the Eclipse Marketplace window, select the GitLab For Eclipse category.
  5. Select Confirm >, then select Finish.
  6. If the Trust Authorities window appears, select the https://gitlab.com update site and select Trust Selected.
  7. Select Restart Now.

Connect to GitLab

After you install the extension, connect it to your GitLab account.

Create a personal access token

If you are on a GitLab Self-Managed instance, create a personal access token.

  1. In GitLab, on the left sidebar, select your avatar.
  2. Select Edit profile.
  3. On the left sidebar, select Access tokens.
  4. Select Add new token.
  5. Enter a name, description, and expiration date.
  6. Select the api scope.
  7. Select Create personal access token.

Authenticate with GitLab

After you configure the plugin in your IDE, connect it to your GitLab account:

  1. In your IDE, select Eclipse > Settings….
  2. On the left sidebar, select GitLab.
  3. Provide the Connection URL. For GitLab.com, use https://gitlab.com.
  4. For GitLab Personal Access Token, paste in the personal access token you created. The token is displayed while being entered for the first time. After applying, the token is not displayed and stored using the Eclipse secure storage.
  5. Under the GitLab settings, select Apply.
  6. Select Apply and Close.