Skip to content

quickstart-deploy-aspnet-web-app.md

Latest commit

 

History

History
370 lines (194 loc) · 15.8 KB

quickstart-deploy-aspnet-web-app.md

File metadata and controls

370 lines (194 loc) · 15.8 KB
title Publish an ASP.NET web app
description Use the Publish tool in Visual Studio to deploy ASP.NET and ASP.NET Core apps to local web servers like IIS or remote cloud environments like Azure App Service.
ms.date 02/23/2026
ms.topic quickstart
helpviewer_keywords
deployment, web app
author ghogen
ms.author ghogen
ms.subservice deployment
ms.custom sfi-image-nochange

Quickstart: Publish an ASP.NET web app

In this article, you'll learn how to publish your first ASP.NET web app to various locations including a local web server such as IIS and a remote cloud environment such as Azure App Service.

This article supports ASP.NET and ASP.NET Core.

Note

This article covers manual deployment, which is great for quickly getting something up and running, but for larger projects and production scenarios, you might want to set up a deployment pipeline. You can use GitHub Actions or Azure Pipelines to set up automatic deployments with continuous integration for such scenarios.

Prerequisites

You need Visual Studio installed with the ASP.NET and web development workload.

If you've already installed Visual Studio:

  • Install the latest updates in Visual Studio by selecting Help > Check for Updates.
  • Add the workload by selecting Tools > Get Tools and Features.

Get started

In Solution Explorer, right-click your project and choose Publish.

:::moniker range="visualstudio"

Screenshot showing the Publish option.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish option.

:::moniker-end

If you're publishing this web app for the first time, next you see the Publish wizard.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard, showing the available publish targets.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard, showing the available publish targets.

:::moniker-end

Note

Visual Studio filters the list of destinations depending on the type of web app.

Azure

For detailed steps on publishing your web app, see Quickstart: Deploy an ASP.NET web app.

Container registry

This section describes publishing to a container registry. You can publish your web app as a Docker container to any compatible Docker Container Registry.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard, with Publish to Docker Container Registry highlighted.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard, with Publish to Docker Container Registry highlighted.

:::moniker-end

Select Next and choose from the available options, such as Azure Container Registry or Docker Hub.

:::moniker range="visualstudio"

Screenshot showing the Publish to Docker Container Registry options.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish to Docker Container Registry options.

:::moniker-end

Azure Container Registry

Next, for Azure Container Registry, either select an existing instance or create a new one.

:::moniker range="visualstudio"

Screenshot showing the option to publish to Azure Container Registry.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the option to publish to Azure Container Registry.

:::moniker-end

Docker Hub

Next, for Docker Hub, provide the publish credentials.

:::moniker range="visualstudio"

Screenshot showing the option to publish to Docker Hub.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the option to publish to Docker Hub.

:::moniker-end

Other Docker Container Registry

Next, for other Docker container registries, provide the URI and publish credentials.

:::moniker range="visualstudio"

Screenshot showing the option to publish to another Docker Container Registry.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the option to publish to another Docker Container Registry.

:::moniker-end

Publish container image

Next, you see the summary page for the new publish profile that you just created using the Publish wizard. Select Publish and Visual Studio deploys your web app to the specified Docker Container Registry.

:::moniker range="visualstudio"

Screenshot showing the summary page.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the summary page.

:::moniker-end

Note

The above screenshot is showing a publish profile targeting Azure Docker Registry, but the same Publish button is available for all three Docker Container Registry options.

Filesystem folder

You can publish your web app to both local and network folders.

:::moniker range="visualstudio"

Screenshot showing the option to publish to a folder highlighted.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the option to publish to a folder highlighted.

:::moniker-end

First, provide the path and select Finish to complete the Publish wizard.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard screen to publish to folder.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard screen to publish to folder.

:::moniker-end

Next, you see the summary page for the new publish profile that you just created using the Publish wizard. Select Publish and Visual Studio deploys your web app to the provided path.

:::moniker range="visualstudio"

Screenshot showing the publish to folder summary page.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the publish to folder summary page.

:::moniker-end

You can come back to this summary page after you close it. Next time you right-click and choose Publish, Visual Studio opens this summary page. (To get back to the Publish wizard just select New in the summary page.)

FTP/FTPS server

You can publish your web app using FTP or FTPS.

:::moniker range="visualstudio"

Screenshot showing the publish to FTP or FTPS Server option.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the publish to FTP or FTPS Server option.

:::moniker-end

Provide the necessary connection details and choose Finish.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard screen to publish to FTP or FTPS Server.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard screen to publish to FTP or FTPS Server.

:::moniker-end

Next, you see the summary page for the new publish profile that you just created using the Publish wizard. Select Publish and Visual Studio deploys your web app to the provided FTP or FTPS Server.

:::moniker range="visualstudio"

Screenshot showing the completion of the process to publish to FTP or ftps server, summary page.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the completion of the process to publish to FTP or ftps server, summary page.

:::moniker-end

You can come back to this summary page after you close it. The next time you right-click and publish, Visual Studio opens this summary page. (To get back to the Publish wizard just select New in the summary page.)

Web Server (IIS)

You can publish your web app to IIS if IIS is configured. By default, IIS Express is installed, but you should install the IIS Management tools if you're deploying to IIS from Visual Studio. Note that you don't need to run Visual Studio as Administrator to deploy to IIS Express, only to full IIS.

Configure the web server

On the remote web server, install the Web Management Service. Be sure to follow the instructions there to enable remote connections, and make sure the service is started, set up your credentials to remotely administer the web server, and verify them before attempting to deploy. Web Management Service is not required for a local IIS deployment.

On the web server, install IIS 6 Metabase Compatibility. In Windows Settings, under Programs and Features, choose Turn Windows features on or off. Then under Internet Information Services > Web Management Tools, install IIS 6 Management Compatibility. Make sure that IIS Metabase and IIS 6 configuration compatibility are selected.

To configure IIS for ASP.NET Core applications, install the .NET Core Hosting Bundle installer (direct download). For more information, see .NET Core hosting bundle.

If you're working with ASP.NET 4.8 or earlier, or if you need to configure IIS on Windows Server for publishing, you can find detailed steps in Remote debugging ASP.NET on an IIS computer and for ASP.NET Core, Remote debugging ASP.NET Core on an IIS computer.

Warning

A web server must be configured with security best practices in mind. Refer to the IIS documentation for recommended security practices. For IIS 8, see Security Best Practices for IIS 8.

Publish to IIS web server

Choose Publish, and then Web Server (IIS).

:::moniker range="visualstudio"

Screenshot showing the option to publish to IIS.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the option to publish to IIS.

:::moniker-end

Pick the desired deployment mode. Choose Web Deploy to immediately deploy the application to the specified server. Choose Web Deploy Package to create a packaged zip file that contains the deployment artifacts for later use by you or someone else.

:::moniker range="visualstudio"

Screenshot showing the option to publish to IIS, showing the choice of deployment mode.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the option to publish to IIS, showing the choice of deployment mode.

:::moniker-end

Web Deploy

Provide the necessary connection details and choose Finish. The following screenshot shows a web application published to the default IIS web site (Default Web Site) installed on the local development machine, with a port binding on port 5187. The Destination URL is optional. If not provided, the web site is not automatically launched on publish, and there won't be a link on the Publish screen to access the published site.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard screen to publish to IIS with the Web Deploy option.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard screen to publish to IIS with the Web Deploy option.

:::moniker-end

The first time you publish, create a username and password. These credentials are specific to WebDeploy deployment. Once they're created, you can't change them in Visual Studio, but you can reset them in IIS. See Sites - Set Credentials dialog box. If you don't have the password, you can download a .publishsettings file, and read it from there. See Import publish settings from IIS.

Warning

Using username and password credentials (basic authentication) is not the most secure method of authentication. Whenever possible, use alternative methods. For example, consider publishing to a package from Visual Studio, and then use WebDeploy.exe from a command line to deploy the package. With that method, you can use IIS Manager to configure authorized Windows users who can publish to the web server, and run WebDeploy.exe under that Windows user account. See Installing and Configuring Web Deploy on IIS 8.0 or Later. If you do use password credentials, be sure to use a strong password, and secure the password from being leaked or shared.

For troubleshooting, see Web Deploy error codes.

Web Deploy Package

Select Browse... to open a Select Package Location dialog box and enter the path to where you want the package to be created, including the .zip file name.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard screen to publish to IIS with the Web Deploy Package option.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard screen to publish to IIS with the Web Deploy Package option.

:::moniker-end

Finish the Publish wizard

Next, you see the summary page for the new publish profile that you just created using the Publish wizard. Select Publish and Visual Studio deploys your web app to the specified IIS server.

:::moniker range="visualstudio"

Screenshot showing the Publish wizard, publish to IIS summary page.

:::moniker-end

:::moniker range="<=vs-2022"

Screenshot showing the Publish wizard, publish to IIS summary page.

:::moniker-end

Import publish profile

You can import publish settings from IIS and Azure App Service

Next steps

Manage settings for your web application deployment. By managing settings, you can control the .NET deployment options, as well as behaviors such as how to handle existing files that are not part of the deployment process at the deployment destination. See Manage web deployment settings.

Related Content