Configure editor extensions

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Configure editor extensions settings for your GitLab instance.

Create an OAuth application

{{< history >}}

• Introduced in GitLab for VS Code 6.47.0.

{{< /history >}}

You can configure editor extensions to connect and authenticate with GitLab using an OAuth application ID. The configuration steps differ depending on your IDE.

VS Code

To create an OAuth application for VS Code:

1. Create an instance-wide application.
2. In Redirect URI, enter vscode://gitlab.gitlab-workflow/authentication.
   • To specify additional IDEs like Code Insiders or Cursor, add multiple redirect URIs separated by newlines.
3. Select the api scope.
4. Select Submit.
5. Copy the Application ID. Use this for the gitlab.authentication.oauthClientIds setting in your VS Code configuration.

JetBrains IDEs

To create an OAuth application for JetBrains IDEs:

1. Create an instance-wide application.
2. In Redirect URI, enter http://127.0.0.1/api/oauth/gitlab/authorization.
3. Select the api scope.
4. Select Submit.
5. Copy the Application ID. Use this when configuring the GitLab Duo plugin in your JetBrains IDE.

Require a minimum language server version

{{< history >}}

• Introduced in GitLab 18.1 with a flag named enforce_language_server_version. Disabled by default.

{{< /history >}}

[!flag] On GitLab Self-Managed, by default this feature is not available. To make it available, an administrator can enable the feature flag named enforce_language_server_version. On GitLab.com, this feature is available but can be configured by GitLab.com administrators only. On GitLab Dedicated, this feature is available.

By default, any GitLab Language Server version can connect to your GitLab instance when personal access tokens are enabled. To block requests from clients on older versions, configure a minimum language server version. Clients older than the minimum allowed Language Server version receive an API error.

Prerequisites:

• You must be an administrator.

  rubyCopy

  # For a specific user
  Feature.enable(:enforce_language_server_version, User.find(1))
  
  # For this GitLab instance
  Feature.enable(:enforce_language_server_version)
  

To enforce a minimum GitLab Language Server version:

1. In the upper-right corner, select Admin.
2. In the left sidebar, select Settings > General.
3. Expand Editor Extensions.
4. Check Language Server restrictions enabled.
5. Under Minimum GitLab Language Server client version, enter a valid GitLab Language Server version.

To allow any GitLab Language Server clients:

1. In the upper-right corner, select Admin.
2. In the left sidebar, select Settings > General.
3. Expand Editor Extensions.
4. Uncheck Language Server restrictions enabled.
5. Under Minimum GitLab Language Server client version, enter a valid GitLab Language Server version.

[!note] Allowing all requests is not recommended. It can cause incompatibility if your GitLab version is ahead of your extension version. You should update your extensions to receive the latest feature improvements, bug fixes, and security fixes.