Skip to content
Coder Docs
User guidesWorkspace accessJetBrains IDEs

JetBrains Toolbox

Connect to and manage your Coder workspaces from the JetBrains Toolbox app.

On this page

JetBrains Toolbox helps you manage JetBrains products and includes remote development capabilities for connecting to Coder workspaces.

For more details, visit the official JetBrains documentation.

Install the Coder provider for Toolbox

These instructions use Coder plugin version 0.9.5 or later, which requires JetBrains Toolbox version 3.9.0 or later.

  1. Install JetBrains Toolbox version 3.9.0 or later.
  2. Open the Toolbox App.
  3. From the switcher drop-down, select Manage Providers.
  4. In the Providers window, select the Coder provider.
  5. Select Install or update an existing installation to version 0.9.5 or later.

Install the Coder provider in JetBrains Toolbox

Connect

  1. In the Toolbox App, select Coder.

  2. Enter the URL address and select Sign In. JetBrains Toolbox Coder provider URL

  3. Authenticate to Coder adding a token for the session and select Connect.

    JetBrains Toolbox Coder provider token

    After the authentication is completed, you are connected to your development environment and can open and work on projects.

    JetBrains Toolbox Coder Workspaces

Use URI parameters

For direct connections or creating bookmarks, use custom URI links with parameters:

jetbrains://gateway/com.coder.toolbox?url=https://coder.example.com&token=<auth-token>&workspace=my-workspace

Required parameters:

  • url: Your Coder deployment URL
  • token: Coder authentication token
  • workspace: Name of your workspace

Optional parameters:

  • agent_id: ID of the agent (only required if workspace has multiple agents)
  • folder: Specific project folder path to open
  • ide_product_code: Specific IDE product code (for example, "IU" for IntelliJ IDEA Ultimate)
  • ide_build_number: Specific build number of the JetBrains IDE

For more details, see the coder-jetbrains-toolbox repository.

Configure internal certificates

To connect to a Coder deployment that uses internal certificates, configure the certificates directly in the Coder plugin settings in JetBrains Toolbox:

  1. In the Toolbox App, select Coder.
  2. Select the (⋮) next to the username in top right corner.
  3. Select Settings.
  4. Add your certificate path in the CA Path field. JetBrains Toolbox Coder Provider certificate path

Troubleshooting

If you encounter issues connecting to your Coder workspace via JetBrains Toolbox, follow these steps to enable and capture debug logs:

Enable Debug Logging

  1. Open Toolbox
  2. Navigate to the Toolbox App Menu (hexagonal menu icon) > Settings > Advanced.
  3. In the screen that appears, select DEBUG for the Log level: section.
  4. Hit the back button at the top.
  5. Retry the same operation

Capture debug logs

  1. Access logs via Toolbox App Menu > About > Show log files.
  2. Locate the log file named jetbrains-toolbox.log and attach it to your support ticket.

After sign-in, Coder's main page lists environments, each representing a workspace and agent pair. For a workspace diagnostic archive, select Collect logs from the environment's action menu on that page or in the individual environment view. With Coder plugin version 0.9.5 or later, the archive also includes a nested coder-support.zip. The bundle contains Coder deployment, workspace, and agent diagnostics, plus local CLI SSH logs when available. For the requirements, collection procedure, and archive contents, refer to Generate from your IDE, under JetBrains Toolbox.

Note

The general Settings > About > Collect logs and diagnostic data action does not generate a Coder support bundle.

With Coder plugin version 0.9.4 or earlier, use the log-collection instructions on this page and generate a Coder support bundle separately with the CLI. Upgrading Toolbox alone doesn't add bundle collection to those plugin versions.

Additional Resources

Edit on GitHub