{"id":5989,"date":"2022-04-08T16:05:37","date_gmt":"2022-04-08T15:05:37","guid":{"rendered":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=5989"},"modified":"2026-02-11T19:06:40","modified_gmt":"2026-02-11T19:06:40","slug":"vscode","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/tools\/vscode\/","title":{"rendered":"VSCode"},"content":{"rendered":"

Overview<\/h2>\n

Visual Studio Code is a popular AI code editor by Microsoft.<\/p>\n

Restrictions on use<\/h2>\n

Please ensure you read, understand and comply with the VSCode licensing terms and conditions<\/a>.<\/p>\n

Set up procedure<\/h2>\n

To use\/access the software you must load any ONE of the available modulefiles:<\/p>\n

\r\nmodule load apps\/binapps\/vscode\/1.109.2<\/strong>       #Recommended version\r\nmodule load apps\/binapps\/vscode\/1.48\r\n<\/pre>\n
Interactive development using VSCode<\/h2>\n
To do interactive development in CSF3 using VSCode you need to run VSCode server in an interactive job<\/a>.
\nBefore you do that, you should first install necessary components for your software development in your account. For example, if you intend to work with Tensorflow, you need to first installTensorflow<\/a> in a virtual environment<\/a>. Once that is ready, you should then be able to select that as your code interpreter in VSCode.<\/a><\/p>\n
Steps that you should follow for interactive development.<\/h3>\n
STEP 1: Start an interactive CPU<\/a> or GPU<\/a> job.<\/strong> <\/p>\n
\r\n#Interactive CPU Job\r\nsrun -p interactive -n 4 -t 0-1 --pty bash\r\n\r\n#or\r\n\r\n#Interactive GPU Job\r\nsrun -p gpuL -G 1 -n 1 -t 0-1 --pty bash\r\n<\/pre>\n
STEP 2: Load VS Code module and run VS Code Server<\/strong> <\/p>\n
\r\nmodule load apps\/binapps\/vscode\/1.109.2\r\ncode tunnel\r\n#or\r\ncode tunnel --accept-server-license-terms\r\n<\/pre>\n
The Visual Studio Code Server will start running in the compute node where your interactive job is running. It will prompt you to select the Account using which you would like to log in to the VSCode interface.
\n\"\"
\n
\nSelect your preferred option using UP and DOWN arrow keys and then hit ENTER.
\n
\n\"\"
\n
\nIt will then present a URL and prompt you to open the URL in a browser, login to it using your account (Microsoft\/Github) and authenticate using the code that is displayed and grant permission. Screenshots given below for reference:
\n
\n\"\"
\n
\n\"\"
\n
\n\"\"
\n
\n\"\"
\n
\n\"\"
\n
\nWhen the above part is completed, you will be then presented with a new URL.
\n
\n\"\"<\/p>\n
STEP 3: Accessing the VSCode interface.<\/strong> <\/p>\n
You need to copy the URL and open it in a web browser. Opening it in a browser will present you with the interface of Visual Studio Code that is running in the compute node of CSF3.<\/p>\n
\"\"<\/a><\/p>\n
You can then create a new file and then select your python virtual environment that you created earlier as interpreter by pressing the keys Ctrl+Shift+P<\/strong> and then selecting the option: Python: Select Interpreter<\/strong>.<\/p>\n
NOTE:<\/strong> You will need to install the Python Extension in VSCode<\/a> to be able to do that.<\/p>\n
It is also possible to use Jupyter Notebooks<\/strong> inside VSCode for your development. For this, you will first need to install Jupyter Notebook in your virtual environment<\/a> and then also install Jupyter Notebook Extension in VSCode<\/a>. Once those are set, reload VSCode and then you can press Ctrl+Shift+P<\/strong> and select the option: Create: New Jupyter Notebook<\/strong>. Remember to select the virtual environment as the interpreter by pressing the keys Ctrl+Shift+P<\/strong> and then selecting the option: Python: Select Interpreter<\/strong>.<\/p>\n
Similarly, if you want to use GitHub Copilot<\/strong> you will need to install GitHub Copilot Chat Extension in VSCode<\/a>.<\/p>\n
Stopping VSCode server<\/h3>\n
Over the years, there has been changes in the way VSCode server process is stopped. Currently the ideal way is to save your files, then close the browser and finally cancel the job with scancel [jobid]<\/code><\/strong><\/a> command to stop the interactive job.<\/p>\n
 
\n 
\n 
\n 
\n 
\n 
\n 
\n 
\n 
\n <\/p>\n
Using VSCode installed on your PC\/laptop<\/h2>\n
We recommend that you install VSCode on your<\/em> PC\/laptop and use the Remote - SSH<\/code> extension to connect VSCode to the CSF. You can then edit files stored on the CSF using your local copy of VSCode. This will give a better experience when using VSCode and allows you to install the latest version.<\/p>\n
VSCode 1.90.2 — 1.99: The “SSH Extension” in VSCode will warn that it is about to connect to a system with an unsupported Operating System. But it is safe to proceed.
\n\"VSCode<\/a><\/div>\n
Older versions of VSCode do not work on the CSF – please use 1.90.2 or newer.<\/p>\n
Acceptable Use<\/h3>\n
Please note that VScode can be used for code development on the CSF – it will give you access to the login nodes and your CSF files. <\/p>\n
But you should not<\/em> run your code for long periods of time within VSCode. Doing so runs you code on the login node. Production runs should be submitted to the CSF batch system outside of VScode, in the usual manner.<\/p>\n
CPU-hogging VScode processes found running on the login nodes will be killed without warning.<\/strong> <\/p>\n
Configure VSCode Before Connecting to the CSF – don’t follow symlinks<\/h3>\n
Please follow these instructions to configure your VSCode client BEFORE CONNECTING TO THE CSF FOR THE FIRST TIME<\/strong> – failure to do so can result in high system load on the CSF login node, which can result in the login nodes being slow for other users, and may require your login to be terminated.<\/p>\n
    \n
  1. Open the File > Preferences > Settings<\/code> panel (or use the shortcut Ctrl+,<\/code>).\n
    \"VS<\/a>\n<\/li>\n
  2. In the search bar at the top, enter the following string: search.follow<\/code>\n
    \"Search<\/a>\n<\/li>\n
  3. UNTICK the Follow Symlinks<\/code> option. This will reduce the amount of file search that VSCode performs on the CSF login node.
    \n    \"Untick<\/a>\n<\/li>\n<\/ol>\n
    You can then close the settings tab and proceed with the steps below to install the Remote SSH extension.<\/p>\n
    Installing the VSCode “Remote – SSH” extension on your PC\/Laptop<\/h3>\n
    You must install the Remote - SSH<\/code> extension in to your local copy of VSCode on your<\/em> PC\/laptop.<\/p>\n
    \"Install<\/a><\/p>\n
    Setting up the connection to CSF for the first time using “Remote – SSH” extension<\/h4>\n
      \n
    1. \nOnce Remote SSH Extension is installed ensure that the following are ticked\/set in the Remote SSH extension settings<\/code>:<\/p>\n
      \"Remote<\/a><\/p>\n
      \r\n# Tick \/ enable the following options\r\nRemote.SSH: Enable Agent Forwarding\r\nRemote.SSH: Enable Dynamic Forwarding\r\nRemote.SSH: Enable X11 Forwarding\r\nRemote.SSH: External SSH_ASKPASS\r\nRemote.SSH: Local Server Download -- Set to 'off'<\/strong> in the drop-down menu\r\nRemote.SSH: Show Login Terminal\r\nRemote.SSH: Use Flock\r\nRemote.SSH: Use Local Server\r\n<\/pre>\n<\/li>\n
    2. \nNext you need to setup the remote host CSF3<\/strong>.<\/p>\n
      Hit F1<\/strong> in your keyboard and select Remote-SSH: Connect to Host...<\/code><\/p>\n
      \"Remote<\/a><\/p>\n
      Then select + Add New SSH Host...<\/code><\/p>\n
      \"Remote<\/a><\/p>\n
      Type:
      \n<username>@csf3.itservices.manchester.ac.uk<\/code> under ‘Enter SSH Connection Command’<\/strong><\/p>\n
      📝Note:<\/strong> Please use your IT Username, not your email username.<\/p>\n
      \"Remote<\/a>\n<\/li>\n
    3. \nConnecting to the CSF. Once you have defined the remote host, you are ready to connect to the CSF.  <\/p>\n
      Hit F1<\/strong> in your keyboard and select the remote host that you have defined.<\/p>\n
      In the next screen select Linux<\/code> from the list:<\/p>\n
      \"Remote<\/a><\/p>\n
      In the next screen type your password and then hit enter. Next complete the Duo authentication.<\/p>\n
      NOTE: The CSF password and DUO 2FA prompt will appear in the Login Terminal<\/em> window inside VSCode. You must ensure you have ticked remote.SSH.showLoginTerminal<\/code> as shown in the step 1.<\/strong> above under Setting up the connection to CSF for the first time using \u201cRemote \u2013 SSH\u201d extension<\/strong>.<\/p>\n
      \"Remote<\/a><\/p>\n
      If you have followed the steps correctly, VSCode will install server package within your home directory in CSF under the folder ~\/.vscode-server<\/code>. It will take some time for the installation to complete and this installation part will be done only on the first time you are connecting to CSF using VSCode. When the set up is complete, you will see something like this in the screen and the last line will say: end<\/strong>. This confirms that your setup and connection was successful. <\/p>\n
      \"Remote<\/a>\n<\/li>\n
    4. \nNext time just follow the step 3. Connecting to the CSF<\/strong> onwards to connect again.<\/p>\n
      Once connected, you can open a new terminal to work in CSF directly from VSCode by selecting: + > New Terminal<\/code><\/p>\n
      \"Remote<\/a><\/p>\n
      The new terminal will show you login prompt of CSF like this:<\/p>\n
      \"Remote<\/a>\n<\/li>\n
    5. \nTroubleshooting tip for user migrating from old to new CSF3:<\/p>\n
      If you have any previous installation of VSCode Remote SSH Extension in old CSF3 and are trying to install the VSCode like this in the new CSF3, you should first delete\/rename the old ~\/.vscode-server<\/code> folder in your home directory.\n<\/li>\n<\/ol>\n
      Further info<\/h2>\n