Skip to content

Commit 75875f3

Browse files
EdwardAngertEdwardAngert
committed
jetbrains initial copy and md edit
1 parent 10472c8 commit 75875f3

File tree

1 file changed

+32
-24
lines changed

1 file changed

+32
-24
lines changed

‎docs/user-guides/workspace-access/jetbrains.md

Lines changed: 32 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# JetBrains IDEs
22

3-
We support JetBrains IDEs using
3+
Coder supports JetBrains IDEs using
44
[Gateway](https://www.jetbrains.com/remote-development/gateway/). The following
55
IDEs are supported for remote development:
66

@@ -16,11 +16,11 @@ IDEs are supported for remote development:
1616
## JetBrains Gateway
1717

1818
JetBrains Gateway is a compact desktop app that allows you to work remotely with
19-
a JetBrains IDE without even downloading one. Visit the
20-
[JetBrains website](https://www.jetbrains.com/remote-development/gateway/) to
19+
a JetBrains IDE without downloading one. Visit the
20+
[JetBrains Gateway website](https://www.jetbrains.com/remote-development/gateway/) to
2121
learn more about Gateway.
2222

23-
Gateway can connect to a Coder workspace by using Coder's Gateway plugin or
23+
Gateway can connect to a Coder workspace using Coder's Gateway plugin or
2424
manually setting up an SSH connection.
2525

2626
### How to use the plugin
@@ -75,8 +75,8 @@ manually setting up an SSH connection.
7575
7676
### Update a Coder plugin version
7777

78-
1. Click the gear icon at the bottom left of the Gateway home screen and then
79-
"Settings"
78+
1. Click the gear icon at the bottom left of the Gateway home screen, then
79+
**Settings**.
8080

8181
1. In the **Marketplace** tab within Plugins, enter Coder and if a newer plugin
8282
release is available, click **Update** then **OK**:
@@ -93,31 +93,42 @@ Failed to configure connection to https://coder.internal.enterprise/: PKIX path
9393
```
9494

9595
To resolve this issue, you will need to add Coder's certificate to the Java
96-
trust store present on your local machine. Here is the default location of the
97-
trust store for each OS:
96+
trust store present on your local machine:
9897

99-
```console
100-
# Linux
98+
<div class="tabs">
99+
100+
#### Linux
101+
102+
```none
101103
<Gateway installation directory>/jbr/lib/security/cacerts
104+
```
105+
106+
Use the `keytool` utility that ships with Java:
107+
108+
```shell
109+
keytool -import -alias coder -file <certificate> -keystore /path/to/trust/store
110+
```
111+
112+
#### macOS
102113

103-
# macOS
114+
```none
104115
<Gateway installation directory>/jbr/lib/security/cacerts
105116
/Library/Application Support/JetBrains/Toolbox/apps/JetBrainsGateway/ch-0/<app-id>/JetBrains Gateway.app/Contents/jbr/Contents/Home/lib/security/cacerts # Path for Toolbox installation
117+
```
118+
119+
Use the `keytool` included in the JetBrains Gateway installation:
106120

107-
# Windows
108-
C:\Program Files (x86)\<Gateway installation directory>\jre\lib\security\cacerts
109-
%USERPROFILE%\AppData\Local\JetBrains\Toolbox\bin\jre\lib\security\cacerts # Path for Toolbox installation
121+
```shell
122+
keytool -import -alias coder -file cacert.pem -keystore /Applications/JetBrains\ Gateway.app/Contents/jbr/Contents/Home/lib/security/cacerts
110123
```
111124

112-
To add the certificate to the keystore, you can use the `keytool` utility that
113-
ships with Java:
125+
#### Windows
114126

115-
```console
116-
keytool -import -alias coder -file <certificate> -keystore /path/to/trust/store
127+
```none
128+
C:\Program Files (x86)\<Gateway installation directory>\jre\lib\security\cacerts\%USERPROFILE%\AppData\Local\JetBrains\Toolbox\bin\jre\lib\security\cacerts # Path for Toolbox installation
117129
```
118130

119-
You can use `keytool` that ships with the JetBrains Gateway installation.
120-
Windows example:
131+
Use the `keytool` included in the JetBrains Gateway installation:
121132

122133
```powershell
123134
& 'C:\Program Files\JetBrains\JetBrains Gateway <version>/jbr/bin/keytool.exe' 'C:\Program Files\JetBrains\JetBrains Gateway <version>/jre/lib/security/cacerts' -import -alias coder -file <cert>
@@ -126,11 +137,8 @@ Windows example:
126137
& '%USERPROFILE%\AppData\Local\JetBrains\Toolbox\apps\Gateway\ch-0\<VERSION>\jbr\bin\keytool.exe' '%USERPROFILE%\AppData\Local\JetBrains\Toolbox\bin\jre\lib\security\cacerts' -import -alias coder -file <cert>
127138
```
128139

129-
macOS example:
130140

131-
```shell
132-
keytool -import -alias coder -file cacert.pem -keystore /Applications/JetBrains\ Gateway.app/Contents/jbr/Contents/Home/lib/security/cacerts
133-
```
141+
</div>
134142

135143
## Manually Configuring A JetBrains Gateway Connection
136144

0 commit comments

Comments
 (0)