2022-08-10 01:10:09 +00:00
# JetBrains Gateway
2022-07-30 22:29:05 +00:00
2023-01-29 01:09:41 +00:00
JetBrains Gateway is a compact desktop app that allows you to work remotely with a JetBrains IDE without even downloading one. [See JetBrains' website to learn about and Gateway. ](https://www.jetbrains.com/remote-development/gateway/ )
Gateway can connect to a Coder workspace by using Coder's Gateway plugin or manually setting up an SSH connection.
## Using Coder's JetBrains Gateway Plugin
> The Coder plugin is an alpha state. If you experience problems, please [create a GitHub issue](https://github.com/coder/coder/issues) or share in [our Discord channel](https://discord.gg/coder).
1. [Install Gateway ](https://www.jetbrains.com/help/idea/jetbrains-gateway.html )
1. Open Gateway and click the gear icon at the bottom left and then "Settings"
1. In the Marketplace tab within Plugins, type Coder and then click "Install" and "OK"
1. Click the new "Coder" icon on the Gateway home screen
1. Enter your Coder deployment's Access Url and click "Connect" then paste the Session Token and click "OK"
1. Click the "+" icon to open a browser and go to the templates page in your Coder deployment to create a workspace
1. If a workspace already exists but is stopped, click the green arrow to start the workspace
1. Once the workspace status says Running, click "Select IDE and Project"
1. Select the JetBrains IDE for your project and the project directory then click "Start IDE and connect"
> Note the JetBrains IDE is remotely installed into `~/. cache/JetBrains/RemoteDev/dist`
2022-07-30 22:29:05 +00:00
## Creating a new JetBrains Gateway Connection
2022-07-31 20:06:05 +00:00
1. [Install Gateway ](https://www.jetbrains.com/help/idea/jetbrains-gateway.html )
1. [Configure the `coder` CLI ](../ides.md#ssh-configuration )
2022-07-30 22:29:05 +00:00
1. Open Gateway, make sure "SSH" is selected under "Remote Development"
2022-07-31 20:06:05 +00:00
1. Click "New Connection"
1. In the resulting dialog, click the gear icon to the right of "Connection:"
1. Hit the "+" button to add a new SSH connection
1. For the Host, enter `coder.<workspace name>`
1. For the Port, enter `22` (this is ignored by Coder)
2022-08-30 16:18:04 +00:00
1. For the Username, enter your workspace username
2022-07-31 20:06:05 +00:00
1. For the Authentication Type, select "OpenSSH config and authentication
agent"
1. Make sure the checkbox for "Parse config file ~/.ssh/config" is checked.
1. Click "Test Connection" to validate these settings.
1. Click "OK"
1. Select the connection you just added
1. Click "Check Connection and Continue"
1. Select the JetBrains IDE for your project and the project directory.
SSH into your server to create a directory or check out code if you haven't already.
> Note the JetBrains IDE is remotely installed into `~/. cache/JetBrains/RemoteDev/dist`
1. Click "Download and Start IDE" to connect.
