Configure Editor Extensions

Configure Editor Extensions settings for your GitLab instance.

Create an OAuth application

You can configure GitLab Workflow extension for VS Code to connect and authenticate with GitLab using an OAuth application ID.

To create an OAuth application:

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.

Require a minimum language server version

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.

  # 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. On the left sidebar, at the bottom, select Admin. If you’ve turned on the new navigation, in the upper-right corner, select Admin.
2. On 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. On the left sidebar, at the bottom, select Admin. If you’ve turned on the new navigation, in the upper-right corner, select Admin.
2. On 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.