Skip to content

GitLab Language Server

The GitLab Language Server powers various GitLab editor extensions across IDEs.

Configure the Language Server to use a proxy

The gitlab-lsp child process uses the proxy-from-env NPM module to determine proxy settings from these environment variables:

  • NO_PROXY
  • HTTPS_PROXY
  • http_proxy (in lower case)

To configure the Language Server to use a proxy:

::Tabs

:::TabTitle Visual Studio Code

  1. In Visual Studio Code, open your user or workspace settings.
  2. Configure http.proxy to point at your HTTP proxy.
  3. Restart Visual Studio Code to ensure connections to GitLab use the latest proxy settings.

:::TabTitle JetBrains IDEs

  1. In your JetBrains IDE, configure the HTTP Proxy settings.
  2. Restart your IDE to ensure connections to GitLab use the latest proxy settings.
  3. From the Tools > GitLab Duo menu, select Verify setup. Make sure the health check passes.

::EndTabs

Troubleshooting

Enable proxy authentication

You might encounter a 407 Access Denied (authentication_failed) error when using an authenticated proxy:

Request failed: Can't add GitLab account for https://gitlab.com. Check your instance URL and network connection.
Fetching resource from https://gitlab.com/api/v4/personal_access_tokens/self failed

To enable proxy authentication in the Language Server, follow the steps for your IDE:

::Tabs

:::TabTitle Visual Studio Code

  1. Open your user or workspace settings.
  2. Configure http.proxy, including username and password, to authenticate with your HTTP proxy.
  3. Restart Visual Studio Code to ensure connections to GitLab use the latest proxy settings.

NOTE: The VS Code extension does not support the legacy http.proxyAuthorization setting in VS Code for authenticating the language server with an HTTP proxy. Support is proposed in issue 1672.

:::TabTitle JetBrains IDEs

  1. Configure HTTP Proxy settings in your JetBrains IDE.
    1. If using Manual proxy configuration, enter your credentials under Proxy authentication and select Remember.
  2. Restart your JetBrains IDE to ensure connections to GitLab use the latest proxy settings.
  3. From the Tools > GitLab Duo menu, select Verify setup. Make sure the health check passes.

::EndTabs

NOTE: Bearer authentication is proposed in issue 548.