JetBrains

Gitpod seamlessly integrates with JetBrains IDEs including IntelliJ IDEA Ultimate, GoLand, PhpStorm, PyCharm, RubyMine, WebStorm, Rider, CLion, and RustRover.

This guide will walk you through the setup process and provide tips for managing your development environments.

​

Prerequisites

Before starting, ensure that you have:

1. JetBrains Toolbox installed on your system

Tip: Keep JetBrains Toolbox for the best experience.

​

Opening an Environment

1. Start an environment in Gitpod
2. Select your preferred JetBrains IDE (e.g., “Open IntelliJ IDEA Ultimate”) from the action bar

​

First-time Setup

On your first environment open, the setup process will:

1. Launch JetBrains Toolbox
2. Install the Gitpod plugin when prompted

3. Request authentication with your Gitpod account

​

Connection Process

After authentication, Toolbox will:

1. Download and provision the IDE backend

2. Start your local IDE client

3. Connect to your environment automatically

​

Limitations

• The version of JetBrains IDEs cannot be changed.
• JetBrains IDE settings and plugins cannot be customized.

​

Managing Authentication

To change your Gitpod account or sign out from JetBrains Toolbox:

1. Open JetBrains Toolbox
2. Go to Settings → Providers → Gitpod
3. Click “Sign Out”
4. Click “Sign In” to authenticate with a different account

​

Managing Environments

Toolbox list shows only recent environments you’ve previously opened. Open new environments from Gitpod directly.

​

Rebuilding Dev Containers

When rebuilding a devcontainer:

1. Close your current IDE window
2. Wait for rebuild to complete
3. Return to Gitpod
4. Select the IDE in the action bar to reconnect

​

Troubleshooting

​

Connection Issues

If your IDE doesn’t connect:

1. Verify JetBrains Toolbox is running
2. Ensure your environment is running in Gitpod
3. Try closing the IDE and reopening from Gitpod

​

Collecting Toolbox Logs

For persistent issues:

1. Open JetBrains Toolbox
2. Navigate to Settings → About
3. Click “Show log files”
4. Locate toolbox.log
5. Send to support@gitpod.io

​

Collecting IDE Logs

For persistent issues:

1. Open JetBrains Toolbox
2. Navigate to your environment
3. Click on the three dots next to the IDE entry in the installed IDE list
4. Click “Show log files”
5. Send to support@gitpod.io