Alert icon Use VS Code for Editing Only — Submit Jobs via Scheduler
- Don’t run computations in VS Code.
- Use VS Code only for editing, developing, debugging, and linting code.
-
Submit jobs with
sbatchorsrun.
Visual Studio Code Access
Visual Studio Code (VS Code) Remote – SSH lets you connect to the WAVE HPC over SSH and edit files directly on the remote system using VS Code. Your code runs on the HPC, while VS Code provides a familiar interface with features like code navigation, IntelliSense, and debugging—without requiring files to be stored on your local machine.
Steps to set up VS Code on your local computer and login to the HPC:
- Download and Install VS Code on your local machine (Linux/Mac/Windows) using this link: VS Code.
- Install the Remote - SSH Extension: Open VSCode, go to the Extensions view by clicking on the square icon on the sidebar or pressing Ctrl+Shift+X (windows/linux) and Cmd+Shift+X (Mac). Search for “Remote - SSH” and install it.

- Close VSCode and open it again for the extension to be full added
- Ensure you can log in to the HPC via terminal for verification purposes.
- After successfully logging in through the terminal, Go to VS Code, and open View on the top right taskbar and select command pallete. In the search bar/ select “Remote-SSH: Connect to Host…“ from the Command Palette (F1, ⇧⌘P) and enter the same address as shown in Secure Shell Access.
(<SCU Username>@login.wave.scu.edu)VS Code may ask you to specify a platform. If so, make sure to choose Linux. After a moment, VS Code will connect to the SSH server and set itself up. VS Code will keep you up-to-date using a progress notification and you can see a detailed log in the Remote - SSH output channel.

- After you are connected, you'll be in an empty window. VSCode will open another window where you will be bale to access your HPC environment remotely. You can always refer to the status window in the bottom left corner to check the status of your connection.
- If it has not automatically show up, add a new SSH connection using the command pallette so that VSCode can remember your remote connection for future usage.

- Click this part and type the same SSH command as above. A new window will soon pop up, requesting you to enter your password.
Exploring the environment:
- Navigating Directories and Files: You can open any folder or workspace on the Wave using File > Open… or File > Open Workspace… just as you would locally! (VS Code might prompt you to re-login when changing directories if you don't have password-less login set up!)

- Accessing Terminal: You can access a terminal on the HPC using Terminal> New Terminal. A terminal will open up at bottom to help you interact with the node.

- Viewing different types of files: You can view or open files with various format on VScode just like you access them on a local machine.
- Downloading Files/Directories and copying: You can easily download files or directories from hpc (Remote machine) by right clicking. You can save to the appropriate path on your local machine. Similarly, You can drag and drop files from your local machine to HPC.
Passwordless Login:
Follow this link to setup passwordless login to HPC. Once done, to change the configuration in VS Code, follow the steps below:
- Edit SSH Configuration if needed by opening the Command Palette again and selecting “Remote-SSH: Open Configuration File”. Here you can specify advanced settings like specifying the path to your private key if it's not in the default location.

Note: If you have not created a key for this process or need help troubleshooting, you can refer to the SSH Key Tutorial as a reference.
You can edit this file as you wish according to your preference and as per your parameters. A small example is shown below:
Host wave
HostName login.wave.scu.edu
User username
IdentityFile ~/.ssh/id_rsa
Port 22
ForwardAgent yes
ServerAliveInterval 60
ServerAliveCountMax 120
GSSAPIAuthentication no