Troubleshooting GitLab Duo
When working with GitLab Duo, you might encounter issues.
Start by running a health check to determine if your instance meets the requirements to use GitLab Duo.
For more information on troubleshooting GitLab Duo, see:
- Troubleshooting Code Suggestions.
- GitLab Duo Chat troubleshooting.
- Troubleshooting GitLab Duo Self-Hosted.
If the health check does not resolve your problem, review these troubleshooting steps.
GitLab Duo features do not work on self-managed
In addition to ensuring GitLab Duo features are turned on, you can also do the following:
As administrator, run a health check for GitLab Duo.
In GitLab 17.5 and later, you can use the UI to run health checks and download a detailed report that helps identify and troubleshoot issues.
In GitLab 17.4, you can run the health check Rake task to generate a detailed report that helps identify and troubleshoot issues.
sudo gitlab-rails 'cloud_connector:health_check(root,report.json)'
In GitLab 17.3 and earlier, you can download and run the
health_check
script to generate a detailed report that helps identify and troubleshoot issues.Download the health check script:
wget https://gitlab.com/gitlab-org/gitlab/-/snippets/3734617/raw/main/health_check.rb
Run the script using Rails Runner:
gitlab-rails runner [full_path/to/health_check.rb] --debug --username [username] --output-file [report.txt]
Usage: gitlab-rails runner full_path/to/health_check.rb --debug Enable debug mode --output-file FILE Write a report to FILE --username USERNAME Provide a username to test seat assignments --skip [CHECK] Skip specific check (options: access_data, token, license, host, features, end_to_end)
Verify that the GitLab instance can reach the required GitLab.com endpoints. You can use command-line tools such as
curl
to verify the connectivity.curl --verbose "https://cloud.gitlab.com" curl --verbose "https://customers.gitlab.com"
If an HTTP/S proxy is configured for the GitLab instance, include the
proxy
parameter in thecurl
command.# https proxy for curl curl --verbose --proxy "http://USERNAME:PASSWORD@example.com:8080" "https://cloud.gitlab.com" curl --verbose --proxy "http://USERNAME:PASSWORD@example.com:8080" "https://customers.gitlab.com"
Optional. If you are using a proxy server between the GitLab application and the public internet, disable DNS rebinding protection.
Manually synchronize subscription data.
- Verify that the GitLab instance synchronizes your subscription data with GitLab.
Error: Webview didn't initialize in 10000ms
You might get this error when using GitLab Duo Chat in VS Code Remote SSH or WSL
sessions. The extension might also attempt to incorrectly connect to a 127.0.0.1
address.
This issue occurs when remote environments introduce latency that exceeds the hardcoded 10-second timeout in GitLab VS Code Extension 6.8.0 and later.
To resolve this issue:
In VS Code, select Code > Preferences > Settings.
Select Open Settings (JSON) to edit your
settings.json
file. Alternatively, press F1, enter Preferences: Open Settings (JSON), and select it.Add this setting:
"gitlab.featureFlags.languageServerWebviews": false
Save and reload VS Code.
Troubleshooting GitLab Duo on GitLab Dedicated
GitLab Duo Core should work out-of-the-box on GitLab 18.3 and later for Premium and Ultimate customers.
Pre-production GitLab Dedicated instances do not support GitLab Duo Core by design.
GitLab Duo settings not visible in Admin area
You might experience one or more of these issues:
- The GitLab Duo section doesn’t appear in the Admin area.
- Configuration options are missing.
- API calls return
"addOnPurchases": []
.
These issues occur when your license is not properly synchronized with the instance.
To resolve this issue, create a support ticket to verify license synchronization. Support can check synchronization status and request new license generation if needed.
Error: GitLab-workflow failed: the GitLab Language server failed to start in 10 seconds
You might get this error when using GitLab Duo Chat in the Web IDE.
You might also see console errors about Platform is missing!
This issue occurs when network connectivity to cloud.gitlab.com
and
customers.gitlab.com
is blocked by network configuration.
To resolve this issue:
- Verify outbound connections to
cloud.gitlab.com:443
andcustomers.gitlab.com:443
. - Add Cloudflare IP ranges to your allowlist if needed.
- Check for allowlist or firewall restrictions with private link.
- Follow filtering outbound requests to troubleshoot connectivity issues.
- Test connectivity from the instance.
Error: Unable to resolve resource
You might get this error when the Web IDE fails to load.
Check browser logs for CORS errors: failed to load because it violates the following Content Security policy
.
This issue occurs when CORS policies block required resources.
To resolve this issue:
- Update to GitLab Workflow Extension version 6.35.1 or later.
- Add
https://*.cdn.web-ide.gitlab-static.net
to your CORS policy. - To troubleshoot further, check HAR files for logs. For more information, see create HAR files.
For more information, see CORS issues.
GitLab Duo features not available for users
In addition to turning on GitLab Duo features, you can also do the following:
- If you have GitLab Duo Core, verify that you have:
- A Premium or Ultimate subscription.
- Turned on IDE features.
- If you have GitLab Duo Pro or Enterprise:
- Verify that a subscription add-on has been purchased.
- Ensure that seats are assigned to users.
- For your IDE:
- Verify that the extension or plugin is up-to-date.
- Run health checks, and test the authentication.