coder · matifali · Jun 3, 2025 · May 30, 2025 · May 30, 2025
diff --git a/docs/images/user-guides/jetbrains/toolbox/certificate.png b/docs/images/user-guides/jetbrains/toolbox/certificate.png
diff --git a/docs/images/user-guides/jetbrains/toolbox/install.png b/docs/images/user-guides/jetbrains/toolbox/install.png
diff --git a/docs/images/user-guides/jetbrains/toolbox/login-token.png b/docs/images/user-guides/jetbrains/toolbox/login-token.png
diff --git a/docs/images/user-guides/jetbrains/toolbox/login-url.png b/docs/images/user-guides/jetbrains/toolbox/login-url.png
diff --git a/docs/images/user-guides/jetbrains/toolbox/workspaces.png b/docs/images/user-guides/jetbrains/toolbox/workspaces.png
diff --git a/docs/user-guides/workspace-access/jetbrains/toolbox.md b/docs/user-guides/workspace-access/jetbrains/toolbox.md
@@ -1,17 +1,25 @@
-# JetBrains Toolbox Integration (beta)
+# JetBrains Toolbox (beta)
 
 JetBrains Toolbox helps you manage JetBrains products and includes remote development capabilities for connecting to Coder workspaces.
 
-## Install the Coder plugin for Toolbox
+## Install the Coder provider for Toolbox
 
 1. Install [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/) version 2.6.0.40632 or later.
+1. Open the Toolbox App.
+1. From the switcher drop-down, select **Manage Providers**.
+1. In the **Providers** window, under the Available node, locate the **Coder** provider and click **Install**.
 
-1. Open Toolbox and navigate to the **Remote Development** section.
-1. Install the Coder plugin using one of these methods:
-   - Search for `Coder` in the **Remote Development** plugins section.
-   - Use this URI to install directly: `jetbrains://gateway/com.coder.toolbox`.
-   - Download from [JetBrains Marketplace](https://plugins.jetbrains.com/).
-   - Download from [GitHub Releases](https://github.com/coder/coder-jetbrains-toolbox/releases).
+![Install the Coder provider in JetBrains Toolbox](../../../images/user-guides/jetbrains/toolbox/install.png)
+
+## Connect
+
+1. In the Toolbox App, click **Coder**.
+1. Enter the URL address and click **Sign In**.
+   ![JetBrains Toolbox Coder provider URL](../../../images/user-guides/jetbrains/toolbox/login-url.png)
+1. Authenticate to Coder adding a token for the session and click **Connect**.
+   ![JetBrains Toolbox Coder provider token](../../../images/user-guides/jetbrains/toolbox/login-token.png)
+   After the authentication is completed, you are connected to your development environment and can open and work on projects.
+   ![JetBrains Toolbox Coder Workspaces](../../../images/user-guides/jetbrains/toolbox/workspaces.png)
 
 ## Use URI parameters
 
@@ -40,7 +48,8 @@ For more details, see the [coder-jetbrains-toolbox repository](https://github.co
 
 To connect to a Coder deployment that uses internal certificates, configure the certificates directly in the Coder plugin settings in JetBrains Toolbox:
 
-1. Click the settings icon (⚙) in the lower left corner of JetBrains Toolbox.
+1. In the Toolbox App, click **Coder**.
+1. Click the (⋮) next to the username in top right corner.
 1. Select **Settings**.
-1. Go to the **Coder** section.
 1. Add your certificate path in the **CA Path** field.
+   ![JetBrains Toolbox Coder Provider certificate path](../../../images/user-guides/jetbrains/toolbox/certificate.png)