Connecting via VS Code

Installing SSH extension

  1. Open Visual Studio Code

  2. Press Ctrl + Shift + X to open the extensions panel.

  3. In the search box on the left hand side, type Remote SSH.

  4. This should find lots of extensions, the top one should be Remote - SSH and under this it should say Microsoft.

  5. Click on the extension, and then click install. It may ask you to restart Visual Studio Code


If you are using windows 10, you may not have an SSH client already. You will need to install one so that you can connect to the VM. There are great instructions for installing a client here.

Configuring the SSH Connection

Now that the SSH extension has been installed, we will need to configure it to connect to our VM.

  1. Open visual studio code, and press the `F1` key to access the command palette.

  2. Click on Remote-SSH: Connect to Host…. If you begin typing this, it should appear in the list.

  3. Once you have clicked on this, click on **Add New SSH Host…*, and then type

    ssh ubuntu@<my_vms_ip>
  4. You may be prompted to Select SSH configuration file to update. If so, select C:Users\<Name>\.ssh\config

  5. A pop up box should then appear in the bottom right with an option to Connect. Click on Connect. .. tip:: If the box does not appear follow the instructions for connecting to an existing SSH connection below.

Connecting via SSH

Now that we have configured the SSH connection we will need to connect to it, you may have to do this eveverytime you open VS Code

  1. Open VS Code

  2. Press the `F1` key to access the command palette.

  3. Then click on Remote-SSH: Connect to Host…. You should then see the IP address of the machine you want to connect to in the list, click on it.

  4. This should open up a new window. On Windows this should have a prompt at the top for you to enter your SSH passphrase. On Linux, your system should prompt for the passphrase.

  5. Once it has connected, this window of Visual Studio Code will have access to all the files on the remote machine.

You will probably want access to the terminal for the tutorial. To do this:

  1. Click on Terminal at the top.

  2. Then click on New Terminal.