Weekly Webtips
Published in

Weekly Webtips

Easy Remote Debugging Node.js using VS Code

If you haven’t been using VS Code, you have no idea what you have been missing. This editor with its speed, customization, and an immense sea of plugins, has become my go-to for everything I do. But one of the most under-rated features of VS Code is its debugging capability. In this post, we will see how to perform remote debugging on a server running heedlessly leveraging the power of an SSH tunnel.

Without further ado, let’s get going…


First thing first, you’ll need to have VS Code installed, you can do so by clicking here.

Once you have done that, you can install the Visual Studio Code Remote — SSH extension. The Remote — SSH extension lets you use any remote machine with an SSH server as your development environment. This can greatly simplify development and troubleshooting in a wide variety of situations.

The key benefit of using this extension is that no source code needs to be on your local machine to gain these benefits since the extension runs commands and other extensions directly on the remote machine.

Once you have installed the extension, a special button should appear at the bottom right of your editor

Remote-SSH VS Code Access

This extension will allow us to access remote servers using ssh tunnel for servers running the following platforms:

  • x86_64 Debian 8+, Ubuntu 16.04+, CentOS / RHEL 7+ Linux.
  • ARMv7l (AArch32) Raspbian Stretch/9+ (32-bit).
  • ARMv8l (AArch64) Ubuntu 18.04+ (64-bit).
  • Windows 10 / Server 2016/2019 (1803+) using the official OpenSSH Server.
  • macOS 10.14+ (Mojave) SSH hosts with Remote Login enabled.

Other glibc based Linux distributions for x86_64, ARMv7l (AArch32), and ARMv8l (AArch64) should work if they have the needed prerequisites. See the Remote Development with Linux article for information prerequisites and tips for getting community-supported distributions up and running.

Next, we will need an OpenSSH compatible SSH Client. If you don’t have one already, you can follow the instructions enlisted below for different operating systems

Get Started

Once, you have the extension and an OpenSSH compatible SSH Client installed, you can go back to VS Code and connect as follow:

  • Click on the button left button for the extension or open the command palette with the command Remote-SSH you should see the following options
Remote-SSH VS Code Quick Access
  • Now let’s choose Connect to Host option you should be prompted to put the server details in the following format:

user@host-or-ip or user@domain@host-or-ip

  • Then you’ll be prompted to enter the password

Voila! you’re connected to the remote server through SSH. You can then use File > Open Folder to open a folder on the host machine.

Now, once you open a Node.js application folder on the server, you leverage the use of the VS Code built-in debugger to run and debug your program on the remote server.

Quick Access

I would highly recommend leveraging SSH key-based authentication for quick access to the server to have quick and secure access to your remote host. To set up SSH key-based authentication for your remote host.

Firstly, we’ll create a key pair and then copy the public key to the host. Check to see if you already have an SSH key on your local machine. This is typically located at ~/.ssh/id_rsa.pub on macOS / Linux, and the .ssh directory in your user profile folder on Windows (for example C:\Users\your-user\.ssh\id_rsa.pub). If not, then you can generate with the following command:

ssh-keygen -t rsa -b 4096

Now, we will be using ssh-copy-id to authorize our key-pair to the server:

ssh-copy-id -f -i ~/.ssh/id_rsa.pub user@host-or-ip

You might be prompted to enter the password, you can do so.

Now, we will edit the .ssh/config file to add the entry for ssh access:

Host <host-or-ip>
User <username>
IdentityFile ~/.ssh/id_rsa
ServerAliveInterval 10

Now, that the key-based authentication is set up, you can access the server without the need to enter the IP/Host or authentication details.

That’s pretty much it!

Read more at Grizzlybit 🐻.




Explore the world of web technologies through a series of tutorials

Recommended from Medium

Typescript vs. Javascript: The Key Differences You Should Know in 2022

TypeScript vs. JavaScript: The Key Differences You Should Know — Flatlogic Blog

Vue vs Angular vs React in 2019— Answered

Adding swagger to Ts.ED project

Custom Form Control — Color Picker

How to Iterate through an object keys and values in JavaScript.

Recent Boost Note developments (December)


Advantages of Using AngularJS for App Development

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Zubair Ahmed

Zubair Ahmed

Chief Technology Officer at RAZRLAB

More from Medium

vsce support

Useful GitHub Tricks

Why You Should Dump VSCode, Move To NeoVim, And Why You Shouldn’t

The last time I Googled an encoding tool