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.

Add the GitLab Releases software site

To add the stable GitLab Releases software site:

  1. In your IDE, select Eclipse > Settings….
  2. On the left sidebar, expand Install/Update, then select Available Software Sites.
  3. On the right, select Add… to configure a new software site.
  4. For Name:, use GitLab Releases.

  5. For Location:, copy and paste the following URL: 

    https://gitlab.com/gitlab-org/editor-extensions/gitlab-eclipse-plugin/-/releases/permalink/latest/downloads/
  6. Select Add.
  7. Select Apply and Close.

Install the GitLab for Eclipse plugin

Prerequisites:

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

To install GitLab for Eclipse:

  1. In your IDE, select the Help menu.
  2. Select Install New Software….
  3. Expand Work with:, then select the GitLab Releases software site.
  4. Select Show only software applicable to target environment.
  5. Select the GitLab category to install the GitLab for Eclipse plugin and dependencies.
  6. Select Next >, then select Finish.
  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.