The following instructions, are describing the configuration steps, regarding the Remote Debugging with VS17 on an Azure VM.

Preliminary, you must check the VS version. Each version, corresponds to different Remote Tools

Visual Studio Version Link
2017 download
2015 Upd 3 download
2013 download

Install Remote Tools

At the first step, check Accept the license terms and conditions and click Install.

setup is running…


And finally, the setup is successful


Remote Tools Configuration

Open the Remote Debugger icon

ToolsOptions, check No Authentication /  Allow any user to debug and click OK

After having downloaded and installed the correct VS version you need to configure both Windows & Azure Firewalls.

Visual Studio Version Port
2017 4022
2015 4020
2013 4018


Windows Firewall Configuration

Remote Tools 4022 Default TCP Port for Visual Studio 2017 Remote Debugger


Azure Firewall Configuration 

*** If a Load Balancer exists then you must add the following Inbound Rule ***

Azure Load Balancer NAT Rule


……One step away debugging

Open Visual Studio, DebugAttach to Process…

Type on Connection Target field, IP address:Port, e.g  XXX.XXX.XXX.XXX:4022, and Click Refresh.


Possible Error Messages

Error Message 1:

Causes :

1.Possible firewall (Windows or Azure), Azure Load Balancer (if exists) misconfiguration.
2. Remote Tools process is not running


Error Message 2:


1. On the Remote Debugger, check if the Options are not configured correctly.


Related Links:




Share This