> For the complete documentation index, see [llms.txt](https://cloud-servers.ortusbooks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cloud-servers.ortusbooks.com/aws/ubuntu-based-images/other-engines/commandbox-+-nginx/connecting-to-your-server/connecting-via-vscode.md).

# Connecting via VSCode

You can install the [VSCode Remote Development Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) by visiting the URL or opening VSCode and clicking the extension load button in the IDE and searching for "Remote Development."

![Remote Development Extension](/files/-MZgnQT3W_7SIQQwlbFm)

### Steps to connect to ec2.

* Click in the green box in the bottom left corner of VSCode. This will open a select box already populated with different Remote Development choices. You want to select Remote-SSH: Open SSH Configuration File...

![](/files/-MZgpb0e4WZSoXpSMo9a)

![Remote-SSH: Open SSH Configuration File...](/files/-MZgqOl87VeqTaOQkuBA)

* If you have not created a configuration file you will have this option.  \
  **Remote-SSH: Add New SSH Host...** Select that instead.
* Your configuration file should look something like this after you fill it out.

```
Host ColdBoxDemo
    User ubuntu
    HostName 34.236.192.135
    IdentityFile ~/.ssh/my-pem-that-i-downloaded-when-creating-ec2.pem
```

* Having done that it is time to connect to your ec2 instance. Let's click the green button in the lower left corner. The same one we used to open the configuration file. \
  Let's select "**Remote-SSH: Connect Current Window to Host...**"

![Remote-SSH: Connect Current Window to Host...](/files/-MZguVW_xrsb2Tr3llCY)

* If all works you should have a VSCode screen that looks like the one below. If it does not work you can do what I did, that is to downgrade to VSCode 1.36.1. You can do that with Chocolatey.

```
choco install vscode --version=1.36.1 -y
```

![Notice you are on the ec2 server. You can run CommandBox Commands from here.](/files/-MZi8D9JuORYEKkGbQEW)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cloud-servers.ortusbooks.com/aws/ubuntu-based-images/other-engines/commandbox-+-nginx/connecting-to-your-server/connecting-via-vscode.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.