2022-06-16 16:22:14 +00:00
|
|
|
# IDEs
|
|
|
|
|
|
|
|
The following desktop IDEs have been tested with Coder, though any IDE with SSH
|
|
|
|
support should work:
|
|
|
|
|
2023-01-18 19:02:26 +00:00
|
|
|
- [Visual Studio Code](#visual-studio-code)
|
2022-08-10 01:10:09 +00:00
|
|
|
- [JetBrains with Gateway](./ides/gateway.md)
|
2022-06-16 16:22:14 +00:00
|
|
|
- IntelliJ IDEA
|
|
|
|
- CLion
|
|
|
|
- GoLand
|
|
|
|
- PyCharm
|
|
|
|
- Rider
|
|
|
|
- RubyMine
|
|
|
|
- WebStorm
|
2024-05-09 18:29:53 +00:00
|
|
|
- [JetBrains Fleet](./ides/fleet.md)
|
2022-08-01 13:29:52 +00:00
|
|
|
- Web IDEs (code-server, JupyterLab, JetBrains Projector)
|
2022-08-10 01:10:09 +00:00
|
|
|
- Note: These are [configured in the template](./ides/web-ides.md)
|
|
|
|
- [Emacs](./ides/emacs-tramp.md)
|
2022-06-16 16:22:14 +00:00
|
|
|
|
2023-01-18 19:02:26 +00:00
|
|
|
## Visual Studio Code
|
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
Click `VS Code Desktop` in the dashboard to one-click enter a workspace. This
|
|
|
|
automatically installs the [Coder Remote](https://github.com/coder/vscode-coder)
|
|
|
|
extension, authenticates with Coder, and connects to the workspace.
|
2023-01-18 19:02:26 +00:00
|
|
|
|
|
|
|
![Demo](https://github.com/coder/vscode-coder/raw/main/demo.gif?raw=true)
|
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
You can set the default directory in which VS Code opens via the `dir` argument
|
|
|
|
on the `coder_agent` resource in your workspace template. See the
|
|
|
|
[Terraform documentation for more details](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#dir).
|
2023-06-23 22:52:01 +00:00
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
> The `VS Code Desktop` button can be hidden by enabling
|
|
|
|
> [Browser-only connections](./networking/index.md#Browser-only).
|
2023-01-18 19:02:26 +00:00
|
|
|
|
|
|
|
### Manual Installation
|
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press
|
|
|
|
enter.
|
2023-01-18 19:02:26 +00:00
|
|
|
|
|
|
|
```text
|
|
|
|
ext install coder.coder-remote
|
|
|
|
```
|
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
Alternatively, manually install the VSIX from the
|
|
|
|
[latest release](https://github.com/coder/vscode-coder/releases/latest).
|
2023-01-18 19:02:26 +00:00
|
|
|
|
2022-06-16 16:22:14 +00:00
|
|
|
## SSH configuration
|
|
|
|
|
|
|
|
> Before proceeding, run `coder login <accessURL>` if you haven't already to
|
|
|
|
> authenticate the CLI with the web UI and your workspaces.
|
|
|
|
|
|
|
|
To access Coder via SSH, run the following in the terminal:
|
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
```shell
|
2022-06-16 16:22:14 +00:00
|
|
|
coder config-ssh
|
|
|
|
```
|
|
|
|
|
2022-07-11 15:30:54 +00:00
|
|
|
> Run `coder config-ssh --dry-run` if you'd like to see the changes that will be
|
2022-06-16 16:22:14 +00:00
|
|
|
> made before proceeding.
|
|
|
|
|
|
|
|
Confirm that you want to continue by typing **yes** and pressing enter. If
|
|
|
|
successful, you'll see the following message:
|
|
|
|
|
2023-02-01 20:05:45 +00:00
|
|
|
```console
|
2022-06-16 16:22:14 +00:00
|
|
|
You should now be able to ssh into your workspace.
|
|
|
|
For example, try running:
|
|
|
|
|
|
|
|
$ ssh coder.<workspaceName>
|
|
|
|
```
|
|
|
|
|
|
|
|
Your workspace is now accessible via `ssh coder.<workspace_name>` (e.g.,
|
|
|
|
`ssh coder.myEnv` if your workspace is named `myEnv`).
|
|
|
|
|
2022-07-22 22:32:16 +00:00
|
|
|
## JetBrains Gateway
|
|
|
|
|
2022-07-30 22:29:05 +00:00
|
|
|
Gateway operates in a client-server model, using an SSH connection to the remote
|
|
|
|
host to install and start the server.
|
|
|
|
|
|
|
|
Setting up Gateway also involves picking a project directory, so if you have not
|
|
|
|
already done so, you may wish to open a terminal on your Coder workspace and
|
|
|
|
check out a copy of the project you intend to work on.
|
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
After installing Gateway on your local system,
|
|
|
|
[follow these steps to create a Connection and connect to your Coder workspace.](./ides/gateway.md)
|
2022-07-22 22:32:16 +00:00
|
|
|
|
2022-07-29 19:36:43 +00:00
|
|
|
| Version | Status | Notes |
|
2022-07-30 22:29:05 +00:00
|
|
|
| --------- | ------- | -------------------------------------------------------- |
|
2022-07-29 19:36:43 +00:00
|
|
|
| 2021.3.2 | Working | |
|
2022-07-30 22:29:05 +00:00
|
|
|
| 2022.1.4 | Working | Windows clients are unable to connect to Linux workspace |
|
2022-07-29 19:36:43 +00:00
|
|
|
| 2022.2 RC | Working | Version >= 222.3345.108 |
|
2022-07-22 22:32:16 +00:00
|
|
|
|
2022-08-01 13:29:52 +00:00
|
|
|
## Web IDEs (Jupyter, code-server, JetBrains Projector)
|
2022-06-16 16:22:14 +00:00
|
|
|
|
2023-08-23 09:27:57 +00:00
|
|
|
Web IDEs (code-server, JetBrains Projector, VNC, etc.) are defined in the
|
|
|
|
template. See [IDEs](./ides/web-ides.md).
|
2022-08-07 21:30:15 +00:00
|
|
|
|
2022-08-07 22:22:47 +00:00
|
|
|
## Up next
|
2022-08-07 21:30:15 +00:00
|
|
|
|
2022-09-12 19:07:03 +00:00
|
|
|
- Learn about [Port Forwarding](./networking/port-forwarding.md)
|