1. Install the Remote Development extension pack for VSCode

2. Open VSCode settings

• On Windows/Linux - File > Preferences > Settings

• On macOS - Code > Preferences > Settings

Search for symlink and make sure the symlink searching is unchecked

3. Under VSCode settings, search for remote ssh timeout and manually enter a timeout value i.e. 50s. It should give you enough time to complete 2-Factor Authentication.

4. Edit the ~/.ssh/config file on your local machine, add the following lines. Replace <username> with your Oscar username.

6. In VSCode, select Remote-SSH: Connect to Host… and after the list populates select ccv-vscode-node

1. When prompted in VSCode, please enter your Brown password and complete the DUO authentication. After that, wait about 30 seconds and VSCode should connect to Oscar.

1. If you have an existing virtual environment, proceed to step 2. Otherwise, to create a new virtual environment:

$ python3 -m venv my_env
$ source my_env/bin/activate
#Install packages manually or from requirements.txt file
$ pip install -r requirements.txt

2. Search for Python.VenvPath as shown in the picture below:

3. VSCode expects you to have multiple virtual environments for each of your different python projects, and it expects you to put them all in the same directory. Pointing to the parent directory lets it scan and find all expected virtual environments, and then you can easily toggle between them in interface.

4. Once you have the virtual environment selected, the debugging capabilities should work.

VS Code one-time setup

To use VS Code you will need to be connected to the VPN. Please install the before proceeding.

Step 1: Install VSCode Extension

Install the for VS Code:

Step 2: Uncheck symlink box

Open VS Code settings and uncheck symlink:

Search for symlink and make sure the symlink searching is unchecked

Step 3: Setup Passwordless SSH

Make sure you have set up passwordless SSH authentication to Oscar. If you haven't, please refer to this .

Step 4: Edit the SSH config file

Edit the config file:

Edit the config file on your local machine, add the following lines. Replace <username> with your Oscar username.

Step 5: Fixes

September 10, 2023: Some users have reported issues while connecting to the Oscar VSCode remote extension. This is due to a recent change introduced by VSCode. To address this issue

Step 6: Connect for the first time

In VS Code, select Remote-SSH: Connect to Host… and after the list populates select ccv-vscode-node

Step 7: Initial Setup

Install and set up of VS Code

Step 8: Configure VS Code

Connect to VS Code first.

You can either create a symlink via the ln command below,

or manually create /users/$USER/.vscode-server/data/Machine/settings.json file with following contents

Reconnect to VS Code

1. Click the green icon "Open a Remote Window" in the bottom left corner of VS Code Window. Then click "Connect to Host" in the drop down list.

2. Select the ccv-vscode-node option to connect to Oscar.