docs: fixed broken podman template link and added already-installed ide gateway doc (#6352)

sharkymark · ericpaulsen · web-flow · commit ab077d1f15c0 · 2023-04-21T20:43:19.000Z
Co-authored-by: Eric Paulsen &lt;ericpaulsen@coder.com&gt;
diff --git a/docs/ides/gateway.md b/docs/ides/gateway.md
@@ -4,28 +4,6 @@ JetBrains Gateway is a compact desktop app that allows you to work remotely with
 
 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"
-   ![Gateway Settings and Marketplace](../images/gateway/plugin-settings-marketplace.png)
-1. Click the new "Coder" icon on the Gateway home screen
-   ![Gateway Connect to Coder](../images/gateway/plugin-connect-to-coder.png)
-1. Enter your Coder deployment's Access Url and click "Connect" then paste the Session Token and click "OK"
-   ![Gateway Session Token](../images/gateway/plugin-session-token.png)
-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"
-   ![Gateway IDE List](../images/gateway/plugin-select-ide.png)
-1. Select the JetBrains IDE for your project and the project directory then click "Start IDE and connect"
-   ![Gateway Select IDE](../images/gateway/plugin-ide-list.png)
-   ![Gateway IDE Opened](../images/gateway/gateway-intellij-opened.png)
-
-> Note the JetBrains IDE is remotely installed into `~/. cache/JetBrains/RemoteDev/dist`
-
 ## Creating a new JetBrains Gateway Connection
 
 1. [Install Gateway](https://www.jetbrains.com/help/idea/jetbrains-gateway.html)
@@ -57,3 +35,42 @@ Gateway can connect to a Coder workspace by using Coder's Gateway plugin or manu
    > Note the JetBrains IDE is remotely installed into `~/. cache/JetBrains/RemoteDev/dist`
 1. Click "Download and Start IDE" to connect.
    ![Gateway IDE Opened](../images/gateway/gateway-intellij-opened.png)
+
+## Using an existing JetBrains installation in the workspace
+
+If you would like to use an existing JetBrains IDE in a Coder workspace (or you
+are air-gapped, and cannot reach jetbrains.com), run the following script in the
+JetBrains IDE directory to point the default Gateway directory to the IDE
+directory. This step must be done before configuring Gateway.
+
+```sh
+cd /opt/idea/bin
+./remote-dev-server.sh registerBackendLocationForGateway
+```
+
+> Gateway only works with paid versions of JetBrains IDEs so the script will not be located in the `bin` directory of JetBrains Community editions.
+
+[Here is the JetBrains article](https://www.jetbrains.com/help/idea/remote-development-troubleshooting.html#setup:~:text=Can%20I%20point%20Remote%20Development%20to%20an%20existing%20IDE%20on%20my%20remote%20server%3F%20Is%20it%20possible%20to%20install%20IDE%20manually%3F)
+explaining this IDE specification.
+
+## 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"
+   ![Gateway Settings and Marketplace](../images/gateway/plugin-settings-marketplace.png)
+1. Click the new "Coder" icon on the Gateway home screen
+   ![Gateway Connect to Coder](../images/gateway/plugin-connect-to-coder.png)
+1. Enter your Coder deployment's Access Url and click "Connect" then paste the Session Token and click "OK"
+   ![Gateway Session Token](../images/gateway/plugin-session-token.png)
+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"
+   ![Gateway IDE List](../images/gateway/plugin-select-ide.png)
+1. Select the JetBrains IDE for your project and the project directory then click "Start IDE and connect"
+   ![Gateway Select IDE](../images/gateway/plugin-ide-list.png)
+   ![Gateway IDE Opened](../images/gateway/gateway-intellij-opened.png)
+
+> Note the JetBrains IDE is remotely installed into `~/.cache/JetBrains/RemoteDev/dist`
