Remote Debug ASP.NET Core on Azure App Service (Windows)

This article describes how to attach the Visual Studio debugger to an ASP.NET Core app running on Azure App Service. The following steps enable you to debug the app as though it's running locally.


  • Visual Studio 2022 with the ASP.NET and web development and the Azure development workload installed.

  • You must first deploy an ASP.NET Core app to Azure App Service (Windows) from Visual Studio, and the app must be running.

    For hands-on training that includes App Service deployment, see Remote debug ASP.NET Core on Azure.

  • Your publish profile in Visual Studio must be set to Debug instead of Release before publishing.

Enable remote debugging

Before you can debug this issue with Visual Studio, you must enable the remote debugging feature on the App Service. This setting will allow the Visual Studio debugger to connect to the main App Service web hosting process.

  1. Sign into your own Azure portal.

    Locate your deployed application in the Azure portal. You can find your app by browsing to the App Services page and then selecting the App Service instance. You can also search for the App Service instance directly by name in the search bar at the top. (In this example, the App Service instance is named GitHubBrowser123.)

    A screenshot of Azure search.

  2. On the settings page for the App Service instance, select Configuration on the left navigation, and then choose the General Settings tab.

  3. Towards the bottom of the page, make sure to set the Remote Debugging feature to On and select Visual Studio 2022 as the Remote Visual Studio version.

    A screenshot of the Azure remote debugging settings.

  4. Select Save at the top of the page to persist your changes.

Your app service instance now supports remote debugging through Visual Studio.

Configure debugging settings

Make sure you have completed the following steps in Visual Studio before debugging an app in Azure to ensure success.

  1. First, make sure you have successfully built your project at least one time. A successful build ensures the source code and any necessary compiled files are ready to go. If your application is running locally, make sure to stop the app.


    Make sure the state of your local code matches what was deployed to Azure. This ensures that the local symbol files and source code line up with the deployed app.

  2. Select Debug > Options from the top Visual Studio menu. Ensure that Enable Just My code is unchecked (as shown below), and then select OK.

    Changing this setting allows Visual Studio to debug the optimized code that was deployed to Azure using the necessary symbol files from your local bin folder. Symbol files are used by the debugger as a bridge between compiled, executing code and the source code in Visual Studio, which is why it's important that your local source code matched the deploy app.

    A screenshot of the Visual Studio debugging settings.

Attach the debugger to the App Service

  1. From the main menu at the top of Visual Studio, select Debug > Attach to process to open the corresponding dialog. Using this window you can connect and attach to different targets. In this case, you'll connect to the App Service instance you created in the previous step.

  2. Select the Connection Type drop down and choose the Microsoft Azure App Services option.

  3. Select Find.. next to the Connection Target field to open a dialog that allows you to browse your Azure subscriptions and app services.

  4. Locate and select the App Service instance you created in the previous step, and then choose OK.

  5. The w3wp.exe process should appear in the list of available processes to connect to, which is the main process of the Azure App Service that hosts the deployed application. Select that process and then choose Attach in the bottom right to connect the Visual Studio debugger.

    A screenshot of the attach to process features.

  6. In a C# application file such as Index.cshtml.cs, set a breakpoint by clicking in the left margin. (Or, right-click and choose Breakpoint > Insert breakpoint.)

  7. Take action in the web app to hit the breakpoint. If you're attached to the process but can't hit the breakpoint, make sure your publish profile in Visual Studio is set to a Debug configuration instead of a Release configuration.

  8. (Optional) you can also verify that Visual Studio has loaded the symbol files for your debugging session. Navigate to Debug > Windows > Modules to open the modules window. This window should indicate that the symbol files were successfully loaded after the Just my code configuration changes you made earlier.

    A screenshot of the symbol files window.