Troubleshooting

If you cannot find your issue here or in the documentation, please contact Gitpod via our Support page.

Gitpod logs in VS Code Browser and Desktop

These logs contain information about the workspace, the session, and the Visual Studio Code environment. They are useful for diagnosing connection issues and other unexpected behavior.

Steps to Collect Logs

Open the Command Palette in Visual Studio Code ( CtrlCmd + Shift + P ).
Type Export logs and select Gitpod: Export all logs to download a zip file of the logs.
Make sure to collect these logs from the window of the affected workspace.

Caution: Do NOT share these logs publicly as they may contain sensitive information. Send them to troubleshooting@gitpod.io and include a link to a relevant GitHub issue if needed.

VS Code Desktop: Workspace Connectivity Tracing

If experiencing connectivity issues on VS Code Desktop, enable detailed logging:

In your VS Code settings, set gitpod.lssh.logLevel to debug.
Reproduce the issue, and after reestablishing the connection, collect logs from the affected window.

Enable Workspace Connectivity Tracing

Note: Use this setting only for troubleshooting purposes.

Gitpod logs in JetBrains Gateway

These logs contain information about the workspace, the session, and the JetBrains Gateway. They are useful for diagnosing issues when connecting to a workspace, issues from Gateway Plugins and issues preventing the JetBrains Client to open.

Open the Help menu and select Collect Logs and Diagnostic Data option. After a few seconds, the file manager window will show up, revealing the location where the zip file containing all the logs has been saved.

Important: The content of these logs should NOT be shared publicly as they could contain sensitive information about your workspace. Instead, send them to troubleshooting@gitpod.io along with a link to a corresponding GitHub issue if needed.

Note: Ensure you are using the latest version of JetBrains Gateway and Gitpod JetBrains Gateway plugin, as issues from older versions might have already been fixed.

Gitpod logs in JetBrains Client

These logs contain information about the workspace, the session, and the JetBrains IDE. They are useful for diagnosing connection issues, issues from IDE Plugins, and any unexpected behavior from the client and the server.

Open the Help menu and select Collect Host and Client logs option. After a few seconds, the file manager window will show up, revealing the location where the zip file containing all the logs has been saved.

Note: Ensure you are using the latest version of both JetBrains Gateway and Gitpod JetBrains Gateway plugin, as issues from older versions might have already been fixed.

Why doesn’t the “ClearURLs” browser extension work with Gitpod?

The ClearURLs browser extension for Google Chrome and Mozilla Firefox inhibits Gitpod workspaces from initialising and the problem manifests with the following symptoms:

The dark theme doesn’t load
The bottom left Gitpod button is missing
The VS Code Marketplace does not load
Settings Sync does not work

This issue can be resolved by disabling “ETag filtering” in ClearURLs’ settings. An issue has been created that requests to whitelist Gitpod by default and we would appreciate your upvotes on the issue.

What should I do if JetBrains Gateway and Gitpod aren’t working?

Ensure you are using the latest version of JetBrains Gateway
Ensure you are using the latest version of the Gitpod JetBrains Gateway plugin

What can I do if I have unsynced data inside a workspace but it’s not starting?

While this is a very critical issue, our workspace-team would eventually look into why it’s happening but on the other hand you might not be able to wait while things get fixed. As an user you can try and get your workspace data yourself:

Go to the Gitpod Dashboard
Find your workspace from the list
Download your workspace like so:
You can now either try opening a new workspace or use your local machine for a while.
The downloaded workspace is a tar file which can be extracted with tar -xf <your-workspace-filename-here> command on a new Gitpod workspace or in your Linux/MacOS machine. You can use 7-zip to extract if you’re on windows and don’t have tar.