diff --git a/docs/images/user-guides/jetbrains/toolbox/certificate.png b/docs/images/user-guides/jetbrains/toolbox/certificate.png new file mode 100644 index 0000000000000..4031985105cd0 Binary files /dev/null and b/docs/images/user-guides/jetbrains/toolbox/certificate.png differ diff --git a/docs/images/user-guides/jetbrains/toolbox/install.png b/docs/images/user-guides/jetbrains/toolbox/install.png new file mode 100644 index 0000000000000..75277dc035325 Binary files /dev/null and b/docs/images/user-guides/jetbrains/toolbox/install.png differ diff --git a/docs/images/user-guides/jetbrains/toolbox/login-token.png b/docs/images/user-guides/jetbrains/toolbox/login-token.png new file mode 100644 index 0000000000000..e02b6af6e433c Binary files /dev/null and b/docs/images/user-guides/jetbrains/toolbox/login-token.png differ diff --git a/docs/images/user-guides/jetbrains/toolbox/login-url.png b/docs/images/user-guides/jetbrains/toolbox/login-url.png new file mode 100644 index 0000000000000..eba420a58ab26 Binary files /dev/null and b/docs/images/user-guides/jetbrains/toolbox/login-url.png differ diff --git a/docs/images/user-guides/jetbrains/toolbox/workspaces.png b/docs/images/user-guides/jetbrains/toolbox/workspaces.png new file mode 100644 index 0000000000000..a97b38b3da873 Binary files /dev/null and b/docs/images/user-guides/jetbrains/toolbox/workspaces.png differ diff --git a/docs/user-guides/workspace-access/jetbrains/toolbox.md b/docs/user-guides/workspace-access/jetbrains/toolbox.md index 91a1138946154..9473056022131 100644 --- 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)