Skip to content

quickstart-dotnetcore.md

Latest commit

 

History

History
854 lines (552 loc) · 41.1 KB

quickstart-dotnetcore.md

File metadata and controls

854 lines (552 loc) · 41.1 KB
title Quickstart: Deploy an ASP.NET web app
description Learn how to run web apps in Azure App Service by deploying your first ASP.NET app.
ms.assetid b1e6bd58-48d1-4007-9d6c-53fd6db061e3
ms.topic quickstart
ms.date 12/15/2025
ms.update-cycle 180-days
zone_pivot_groups app-service-ide
adobe-target true
adobe-target-activity DocsExp–386541–A/B–Enhanced-Readability-Quickstarts–2.19.2021
adobe-target-experience Experience B
adobe-target-content ./quickstart-dotnetcore-uiex
author cephalin
ms.author cephalin
ai-usage ai-assisted
ms.collection ce-skilling-ai-copilot
ms.service azure-app-service
ms.custom
devx-track-csharp
mvc
devcenter
vs-azure
devdivchpfy22
devx-track-azurepowershell
devx-track-dotnet
ai-video-demo
devx-track-extended-azdevcli
sfi-image-nochange

Quickstart: Deploy an ASP.NET web app

In this quickstart, you learn how to create and deploy your first ASP.NET web app to Azure App Service. App Service supports various versions of .NET apps. It provides a highly scalable, self-patching web hosting service. ASP.NET web apps are cross-platform and can be hosted on Linux or Windows. When you're finished, you have an Azure resource group that includes an App Service hosting plan and an App Service with a deployed web application.

Alternatively, you can deploy an ASP.NET web app as part of a Windows or Linux container in App Service.

Tip

Find GitHub Copilot tips in the Visual Studio, Visual Studio Code, and Azure portal steps.

Prerequisites

:::zone target="docs" pivot="development-environment-vs"

.NET 10

.NET Framework 4.8

  • An Azure account with an active subscription. Create an account for free.
  • Visual Studio 2026 with the ASP.NET and web development workload. Ensure the optional checkbox .NET Framework project and item templates is selected.

If you already installed Visual Studio 2026:

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

:::zone-end

:::zone target="docs" pivot="development-environment-vscode"

:::zone-end

:::zone target="docs" pivot="development-environment-cli"

:::zone-end

:::zone target="docs" pivot="development-environment-ps"

:::zone-end

:::zone target="docs" pivot="development-environment-azure-portal"

:::zone-end

:::zone target="docs" pivot="development-environment-vs, development-environment-azure-portal, development-environment-ps, development-environment-vscode, development-environment-cli"

Skip to the end

You can quickly deploy the ASP.NET Core sample app in this tutorial using Azure Developer CLI and see it running in Azure. Just run the following commands in the Azure Cloud Shell, and follow the prompt:

mkdir dotnetcore-quickstart
cd dotnetcore-quickstart
azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
azd up

And, to delete the resources:

azd down

Create an ASP.NET web app

:::zone-end

:::zone target="docs" pivot="development-environment-vs"

.NET 10

  1. Open Visual Studio and then select Create a new project.

  2. In Create a new project, find and select Blazor Web App, then select Next.

  3. In Configure your new project, name the application MyFirstAzureWebApp, and then select Next.

  4. Select .NET 10.0 (Long Term Support).

  5. Ensure Authentication type is set to None. Select Create.

    :::image type="content" source="media/quickstart-dotnetcore/vs-additional-info-net-10.png" alt-text="Screenshot of Visual Studio - Additional info when selecting .NET 10.0." lightbox="media/quickstart-dotnetcore/vs-additional-info-net-10.png" border="true":::

  6. From the Visual Studio menu, select Debug > Start Without Debugging to run the web app locally. If you see dialog boxes asking you to trust a self-signed certificate, select Yes.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" alt-text="Screenshot of Visual Studio - ASP.NET Core 10.0 running locally." lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true":::

.NET Framework 4.8

  1. Open Visual Studio and then select Create a new project.

  2. In Create a new project, find and select ASP.NET Web Application (.NET Framework), then select Next.

  3. In Configure your new project, name the application MyFirstAzureWebApp, and then select Create.

    :::image type="content" source="media/quickstart-dotnet/configure-web-app-net-framework-48.png" alt-text="Screenshot of Visual Studio - Configure ASP.NET Framework 4.8 web app." lightbox="media/quickstart-dotnet/configure-web-app-net-framework-48.png" border="true":::

  4. Select the MVC template.

  5. Ensure Authentication is set to No Authentication. Select Create.

    :::image type="content" source="media/quickstart-dotnetcore/vs-mvc-no-auth-net-framework-48.png" alt-text="Screenshot of Visual Studio - Select the MVC template." lightbox="media/quickstart-dotnetcore/vs-mvc-no-auth-net-framework-48.png" border="true":::

  6. From the Visual Studio menu, select Debug > Start Without Debugging to run the web app locally.

    :::image type="content" source="media/quickstart-dotnetcore/vs-local-web-app-net-framework-48.png" alt-text="Screenshot of Visual Studio - ASP.NET Framework 4.8 running locally." lightbox="media/quickstart-dotnetcore/vs-local-web-app-net-framework-48.png" border="true":::

Tip

If you have a GitHub Copilot account, try getting GitHub Copilot features for Visual Studio.

:::zone-end

:::zone target="docs" pivot="development-environment-vscode,development-environment-cli,development-environment-ps"

  1. Open a terminal window on your machine to a working directory. Create a new .NET web app using the dotnet new webapp command, and then change directories into the newly created app.

    dotnet new blazor -n MyFirstAzureWebApp --framework net10.0
cd MyFirstAzureWebApp

  2. From the same terminal session, run the application locally using the dotnet run command.

    dotnet run --urls=https://localhost:5001/

  3. Open a web browser, and navigate to the app at https://localhost:5001.

    You see the template ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" alt-text="Screenshot of Visual Studio Code - ASP.NET Core 10.0 in local browser." lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true":::

:::zone-end

:::zone target="docs" pivot="development-environment-azure-portal"

In this step, you fork a demo project to deploy.

.NET 10

  1. Go to the .NET 10.0 sample app.
  2. Select the Fork button in the upper right on the GitHub page.
  3. Select the Owner and leave the default Repository name.
  4. Select Create fork.

.NET Framework 4.8

  1. Go to the .NET Framework 4.8 sample app.
  2. Select the Fork button in the upper right on the GitHub page.
  3. Select the Owner and leave the default Repository name.
  4. Select Create fork.

:::zone-end

Publish your web app

Follow these steps to create your App Service resources and publish your project:

:::zone target="docs" pivot="development-environment-vs"

  1. In Solution Explorer, right-click the MyFirstAzureWebApp project and select Publish.

  2. In Publish, select Azure and then Next.

    :::image type="content" source="media/quickstart-dotnetcore/vs-publish-target-azure.png" alt-text="Screenshot of Visual Studio - Publish the web app and target Azure." lightbox="media/quickstart-dotnetcore/vs-publish-target-azure.png" border="true":::

  3. Choose the Specific target, either Azure App Service (Linux) or Azure App Service (Windows). Select Next.

    [!IMPORTANT] When targeting ASP.NET Framework 4.8, use Azure App Service (Windows).

  4. Your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. Select either Add an account or Sign in to sign in to your Azure subscription. If you're already signed in, select the account you want.

    :::image type="content" source="media/quickstart-dotnetcore/sign-in-azure.png" border="true" alt-text="Screenshot of Visual Studio - Select sign in to Azure dialog." lightbox="media/quickstart-dotnetcore/sign-in-azure.png" :::

  5. Select Create new.

    :::image type="content" source="media/quickstart-dotnetcore/publish-new-app-service.png" border="true" alt-text="Screenshot of Visual Studio - New App Service app dialog." lightbox="media/quickstart-dotnetcore/publish-new-app-service.png" :::

  6. For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  7. For Resource group, select New. In New resource group name, enter myResourceGroup and select OK.

  8. For Hosting Plan, select New.

  9. In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    Setting Suggested value Description
    Hosting Plan MyFirstAzureWebAppPlan Name of the App Service plan.
    Location West Europe The datacenter where the web app is hosted.
    Size Choose the lowest tier. Pricing tiers define hosting features.

  10. In Name, enter a unique app name. Include only characters a-z, A-Z, 0-9, and -. You can accept the automatically generated unique name.

  11. Select Create to create the Azure resources.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-name.png" border="true" alt-text="Screenshot of Visual Studio - Create app resources dialog." lightbox="media/quickstart-dotnetcore/web-app-name.png" :::

    When the process completes, the Azure resources are created for you. You're ready to publish your ASP.NET Core project.

  12. In the Publish dialog, ensure your new App Service app is selected, then select Finish, then select Close. Visual Studio creates a publish profile for you for the selected App Service app.

  13. In the Publish page, select Publish. If you see a warning message, select Continue.

    Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    .NET 10

    You see the ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true" alt-text="Screenshot of Visual Studio - ASP.NET Core 10.0 web app in Azure." :::

    .NET Framework 4.8

    You see the ASP.NET Framework 4.8 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/vs-azure-web-app-net-48.png" lightbox="media/quickstart-dotnetcore/vs-azure-web-app-net-48.png" border="true" alt-text="Screenshot of Visual Studio - ASP.NET Framework 4.8 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-vscode"

  1. Open Visual Studio Code from your project's root directory.

    code .

  2. If prompted, select Yes, I trust the authors.

    [!TIP] If you have a GitHub Copilot account, try getting GitHub Copilot features for Visual Studio Code.

  3. In Visual Studio Code, select View > Command Palette to open the Command Palette.

  4. Search for and select Azure App Service: Create New Web App (Advanced).

  5. Respond to the prompts as follows:

    1. If prompted, sign in to your Azure account.
    2. Select your Subscription.
    3. Select a location near you.
    4. Select Secure unique default hostname.
    5. Select Create new resource group and provide a name like myResourceGroup.
    6. Enter a name for the new web app.
    7. When prompted to Select a runtime stack, select .NET 10 (LTS).
    8. Select an operating system (Windows or Linux).
    9. Select Create new App Service plan, provide a name, and select the Free (F1) pricing tier.
    10. For the Application Insights resource, select Skip for now for the Application Insights resource.

    Wait for Visual Studio to finish creating the Azure resources.

  6. In Visual Studio Code, select View > Command Palette again.

  7. Search for and select Azure App Service: Deploy to Web App.

    1. Select MyFirstAzureWebApp as the folder to deploy.
    2. Select Add Config when prompted.
    3. Select your Subscription.
    4. Select your web app.
    5. When prompted, select Deploy.

  8. In the dialog Always deploy the workspace "MyFirstAzureWebApp" to <app-name>", select Yes so that Visual Studio Code deploys to the same App Service app every time you're in that workspace.

  9. When publishing completes, select Browse Website in the notification.

    You see the Blazor web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true" alt-text="Screenshot of Visual Studio Code - ASP.NET Core 10.0 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-cli"

  1. Sign into your Azure account by using the az login command and following the prompt:

    az login
    • If the az command isn't recognized, ensure that you have the Azure CLI installed as described in Prerequisites.

  2. Use az webapp up to deploy the code in your local MyFirstAzureWebApp directory:

    az webapp up --sku F1 --name <app-name> --os-type <os>
    • Replace <app-name> with a name that's unique across all of Azure. Valid characters are a-z, 0-9, and -. A good pattern is to use a combination of your company name and an app identifier.
    • The --sku F1 argument creates the web app on the Free pricing tier. Omit this argument to use a faster premium tier, which incurs an hourly cost.
    • Replace <os> with either linux or windows.
    • You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. To get a list of allowable regions for your Azure account, run the az account list-locations command.

    The command might take a few minutes to complete. While it runs, the command provides messages about creating the resource group, the App Service plan, and hosting app, configuring logging, then performing ZIP deployment. Then it shows a message with the app's URL.

  3. Open a web browser and navigate to the URL. You see the ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true" alt-text="Screenshot of the CLI - ASP.NET Core 10.0 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-ps"

Note

We recommend Azure PowerShell for creating apps on the Windows hosting platform. To create apps on Linux, use a different tool, such as Azure CLI.

  1. Sign into your Azure account by using the Connect-AzAccount command and following the prompt:

    Connect-AzAccount

  2. Create a new app by using the New-AzWebApp command:

    New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
    • Replace <app-name> with a name that's unique across all of Azure. Valid characters are a-z, 0-9, and - A combination of your company name and an app identifier is a good pattern.
    • You can optionally include the parameter -Location <location-name> where <location-name> is an available Azure region. To get a list of allowable regions for your Azure account, run the Get-AzLocation command.

    The command might take a few minutes to complete. The command creates a resource group, an App Service plan, and the App Service resource.

  3. From the application root folder, run the dotnet publish command to prepare your local MyFirstAzureWebApp application for deployment:

    dotnet publish --configuration Release

  4. Change to the release directory and create a zip file from the contents:

    cd bin\Release\net10.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip

  5. Publish the zip file to the Azure app using the Publish-AzWebApp command:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force

    [!NOTE] -ArchivePath needs the full path of the zip file.

  6. Open a web browser and navigate to the URL. You see the Blazor web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true" alt-text="Screenshot of the CLI - ASP.NET Core 10.0 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-azure-portal"

  1. In the Azure portal, type app services in the search. Under Services, select App Services.

    :::image type="content" source="./media/quickstart-dotnetcore/portal-search.png" alt-text="Screenshot of portal search in the Azure portal." lightbox="./media/quickstart-dotnetcore/portal-search.png":::

  2. In the App Services page, select Create > Web App.

  3. In the Basics tab:

    .NET 10

    • Under Resource group, select Create new. Enter myResourceGroup for the name.
    • Under Name, enter a globally unique name for your web app.
    • Under Publish, select Code.
    • Under Runtime stack select .NET 8 (LTS).
    • Under Operating System, select Windows. If you select Linux, you can't configure GitHub deployment in the next step, but you can still do it after you create the app in the Deployment Center page.
    • Select a Region you want to serve your app from.
    • Under App Service Plan, select Create new and type myAppServicePlan for the name.
    • Under Pricing plan, select Free F1.

    :::image type="content" source="./media/quickstart-dotnetcore/app-service-details-net-10.png" lightbox="./media/quickstart-dotnetcore/app-service-details-net-10.png" alt-text="Screenshot of new App Service app configuration for .NET 8 in the Azure portal.":::

    .NET Framework 4.8

    • Under Resource group, select Create new. Enter myResourceGroup for the name.
    • Under Name, enter a globally unique name for your web app.
    • Under Publish, select Code.
    • Under Runtime stack select ASP.NET V4.8.
    • Select an Operating System, and a Region you want to serve your app from.
    • Under App Service Plan, select Create new and type myAppServicePlan for the name.
    • Under Pricing plan, select Free F1.

    :::image type="content" source="./media/quickstart-dotnetcore/app-service-details-net-48.png" lightbox="./media/quickstart-dotnetcore/app-service-details-net-48.png" alt-text="Screenshot of new App Service app configuration for .NET Framework V4.8 in the Azure portal.":::

  4. Select the Deployment tab at the top of the page

  5. Under GitHub Actions settings, set Continuous deployment to Enable.

  6. Under GitHub Actions details, authenticate with your GitHub account, and select the following options:

    .NET 10

    • For Organization, select the organization where you forked the demo project.
    • For Repository, select the dotnetcore-docs-hello-world project.
    • For Branch, select main.

    :::image type="content" source="media/quickstart-dotnetcore/app-service-deploy-10.png" lightbox="media/quickstart-dotnetcore/app-service-deploy-10.png" border="true" alt-text="Screenshot of the deployment options for an app using the .NET 10 runtime.":::

    .NET Framework 4.8

    • For Organization, select the organization where you forked the demo project.
    • For Repository, select the app-service-web-dotnet-get-started project.
    • For Branch, select main.

    :::image type="content" source="media/quickstart-dotnet/app-service-deploy-48.png" lightbox="media/quickstart-dotnet/app-service-deploy-48.png" border="true" alt-text="Screenshot of the deployment options for an app using the .NET Framework 4.8 runtime.":::

    [!NOTE] By default, the resource creation disables basic authentication. It creates the GitHub Actions deployment by using a user-assigned identity. If you get a permissions error during resource creation, your Azure account might not have enough permissions. You can configure GitHub Actions deployment later with an identity generated for you by an Azure administrator, or you enable basic authentication instead.

  7. Select Review + create at the bottom of the page.

  8. After validation runs, select Create at the bottom of the page.

  9. After deployment is complete, select Go to resource.

    :::image type="content" source="./media/quickstart-dotnet/next-steps.png" alt-text="Screenshot of the next step of going to the resource.":::

  10. To browse to the created app, select the default domain in the Overview page. If you see the message Your web app is running and waiting for your content, GitHub deployment is still running. Wait a couple of minutes and refresh the page.

    .NET 10

    :::image type="content" source="media/quickstart-dotnetcore/web-app-net-10.png" lightbox="media/quickstart-dotnetcore/web-app-net-10.png" border="true" alt-text="Screenshot of the deployed .NET 10.0 sample app.":::

    .NET Framework 4.8

    :::image type="content" source="media/quickstart-dotnet/browse-dotnet-48.png" lightbox="media/quickstart-dotnet/browse-dotnet-48.png" border="true" alt-text="Screenshot of the deployed .NET Framework 4.8 sample app.":::

:::zone-end

Update the app and redeploy

Make a change the default page and redeploy to see the changes.

:::zone target="docs" pivot="development-environment-vs"

  1. In Solution Explorer, find the default page in your project and replace the content as follows:

    .NET 10

    In Components/Pages/Home.razor, replace everything with the following code:

    @page "/"

<PageTitle>Home</PageTitle>

<h1>.NET 💜 Azure</h1>

Example .NET app to Azure App Service.

    .NET Framework 4.8

    In Views/Home/Index.cshtml, replace the first <div> element with the following code:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    [!TIP] With GitHub Copilot enabled in Visual Studio, try the following steps:

    1. Type Alt+/.
    2. Ask Copilot, "Change to a Bootstrap card that says .NET 💜 Azure."

    Save your changes.

  2. To redeploy to Azure, right-click the MyFirstAzureWebApp project in Solution Explorer and select Publish.

  3. In the Publish summary page, select Publish.

    When publishing completes, Visual Studio launches a browser to the URL of the web app.

    .NET 10

    You see the updated ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/updated-azure-web-app-net.png" lightbox="media/quickstart-dotnetcore/updated-azure-web-app-net.png" border="true" alt-text="Screenshot of Visual Studio - Updated ASP.NET Core 10.0 web app in Azure.":::

    .NET Framework 4.8

    You see the updated ASP.NET Framework 4.8 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/vs-updated-azure-web-app-net-48.png" lightbox="media/quickstart-dotnetcore/vs-updated-azure-web-app-net-48.png" border="true" alt-text="Screenshot of Visual Studio - Updated ASP.NET Framework 4.8 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-vscode"

  1. In your workspace, find Components/Pages/Home.razor and replace everything with the following code:

    @page "/"

<PageTitle>Home</PageTitle>

<h1>.NET 💜 Azure</h1>

Example .NET app to Azure App Service.

    [!TIP] Try this approach with GitHub Copilot:

    1. Select the content and select :::image type="icon" source="media/quickstart-dotnetcore/github-copilot-in-editor.png" border="false":::.
    2. Select Modify.
    3. Enter "Change to a Bootstrap card that says .NET 💜 Azure."

    Save your changes.

  2. In Visual Studio Code, select View > Command Palette again.

  3. Search for and select Azure App Service: Deploy to Web App.

  4. Select the subscription and the web app you used earlier.

  5. When prompted, select Deploy.

  6. When publishing completes, select Browse Website in the notification.

    You see the updated ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/updated-azure-web-app-net.png" lightbox="media/quickstart-dotnetcore/updated-azure-web-app-net.png" border="true" alt-text="Screenshot of Visual Studio Code - Updated ASP.NET Core 10.0 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-cli,development-environment-ps"

Tip

To see how Visual Studio Code with GitHub Copilot helps improve your web development experience, see the Visual Studio Code steps.

:::zone-end

:::zone target="docs" pivot="development-environment-cli"

  1. In the local directory, find Components/Pages/Home.razor and replace everything with the following code:

    @page "/"

<PageTitle>Home</PageTitle>

<h1>.NET 💜 Azure</h1>

Example .NET app to Azure App Service.

  2. Save your changes, then redeploy the app using the az webapp up command again and replace <os> with either linux or windows.

    az webapp up --os-type <os>

    This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and App Service plan.

  3. After deployment completes, switch back to the browser window that opened in the Browse to the app step, and refresh.

    You see the updated ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/updated-azure-web-app-net.png" lightbox="media/quickstart-dotnetcore/updated-azure-web-app-net.png" border="true" alt-text="Screenshot of the CLI - Updated ASP.NET Core 10.0 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-ps"

  1. In the local directory, open Components/Pages/Home.razor and replace everything with the following code:

    @page "/"

<PageTitle>Home</PageTitle>

<h1>.NET 💜 Azure</h1>

Example .NET app to Azure App Service.

  2. From the application root folder, prepare your local MyFirstAzureWebApp application for deployment using the dotnet publish command:

    dotnet publish --configuration Release

  3. Change to the release directory and create a zip file from the contents:

    cd bin\Release\net10.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip -Force

  4. Publish the zip file to the Azure app using the Publish-AzWebApp command:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force

    [!NOTE] -ArchivePath needs the full path of the zip file.

  5. After deployment completes, switch back to the browser window that opened in the Browse to the app step, and refresh.

    You see the updated Blazor web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/updated-azure-web-app-net.png" lightbox="media/quickstart-dotnetcore/updated-azure-web-app-net.png" border="true" alt-text="Screenshot of the CLI - Updated ASP.NET Core 10.0 web app in Azure.":::

:::zone-end

:::zone target="docs" pivot="development-environment-azure-portal"

  1. Browse to your GitHub fork of the sample code.

  2. On your repo page, create a codespace by selecting Code > Create codespace on main.

    .NET 10

    :::image type="content" source="media/quickstart-dotnetcore/github-forked-dotnetcore-docs-hello-world-repo-create-codespace.png" alt-text="Screenshot showing how to create a codespace in the forked dotnetcore-docs-hello-world GitHub repo.":::

    .NET Framework 4.8

    :::image type="content" source="media/quickstart-dotnetcore/github-forked-app-service-web-dotnet-get-started-repo-create-codespace.png" alt-text="Screenshot showing how to create a codespace in the forked app-service-web-dotnet-get-started GitHub repo.":::

  3. In Solution Explorer, find the default page in your project and replace the content as follows:

    .NET 10

    In Components/Pages/Home.razor, replace everything with the following code. The changes are saved automatically.

    @page "/"

<PageTitle>Home</PageTitle>

<h1>.NET 💜 Azure</h1>

Example .NET app to Azure App Service.

    .NET Framework 4.8

    In Views/Home/Index.cshtml, replace the first <div> element with the following code. The changes are saved automatically.

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    [!TIP] Try this approach with GitHub Copilot:

    1. Select all the content and select :::image type="icon" source="media/quickstart-dotnetcore/github-copilot-in-editor.png" border="false":::.
    2. Ask Copilot, "Change to a Bootstrap card that says .NET 💜 Azure."

  4. From the Source Control menu, enter a commit message such as Modify homepage. Then, select Commit and confirm staging the changes by selecting Yes.

    .NET 10

    :::image type="content" source="media/quickstart-dotnetcore/visual-studio-code-in-browser-commit-push-dotnetcore.png" alt-text="Screenshot of Visual Studio Code in the browser, Source Control panel with a commit message of 'We love Azure' and the Commit and Push button highlighted.":::

    .NET Framework 4.8

    :::image type="content" source="media/quickstart-dotnetcore/visual-studio-code-in-browser-commit-push-dotnet-framework.png" alt-text="Screenshot of Visual Studio Code in the browser, Source Control panel with a commit message of 'We love Azure' and the Commit and Push button highlighted.":::

    [!TIP] Let GitHub Copilot create a commit message for you by selecting :::image type="icon" source="media/quickstart-dotnetcore/github-copilot-in-editor.png" border="false"::: in the message box.

  5. Select Sync changes 1, then confirm by selecting OK.

  6. It takes a few minutes for the deployment to run. To view the progress, navigate to https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions.

  7. Return to the browser window that opened during the Browse to the app step, and refresh the page.

    .NET 10

    You see the updated ASP.NET Core 10.0 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnetcore/updated-azure-web-app-net.png" lightbox="media/quickstart-dotnetcore/updated-azure-web-app-net.png" border="true" alt-text="Screenshot of the CLI - Updated ASP.NET Core 10.0 web app in Azure.":::

    .NET Framework 4.8

    You see the updated ASP.NET Framework 4.8 web app displayed in the page.

    :::image type="content" source="media/quickstart-dotnet/updated-azure-webapp-net-48.png" lightbox="media/quickstart-dotnet/updated-azure-webapp-net-48.png" border="true" alt-text="Screenshot of the CLI - Updated ASP.NET Framework 4.8 web app in Azure.":::

:::zone-end

Manage the Azure app

To manage your web app, go to the Azure portal, and search for and select App Services.

:::image type="content" source="media/quickstart-dotnetcore/app-services.png" alt-text="Screenshot of the Azure portal - Select App Services option." lightbox="media/quickstart-dotnetcore/app-services.png":::

On the App Services page, select the name of your web app.

:::image type="content" source="./media/quickstart-dotnetcore/select-app-service.png" alt-text="Screenshot of the Azure portal - App Services page with an example web app selected.":::

The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. The left menu provides further pages for configuring your app.

:::image type="content" source="media/quickstart-dotnetcore/web-app-overview-page.png" alt-text="Screenshot of the Azure portal - App Service overview page." lightbox="media/quickstart-dotnetcore/web-app-overview-page.png":::

:::zone target="docs" pivot="development-environment-vs" [!INCLUDE Clean-up Portal web app resources] :::zone-end

:::zone target="docs" pivot="development-environment-vscode" [!INCLUDE Clean-up Portal web app resources] :::zone-end

:::zone target="docs" pivot="development-environment-cli"

In the preceding steps, you created Azure resources in a resource group. If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete

For your convenience, the az webapp up command that you ran earlier in this project saves the resource group name as the default value whenever you run az commands from this project.

:::zone-end

:::zone target="docs" pivot="development-environment-ps"

[!INCLUDE Clean-up PowerShell resources] :::zone-end

:::zone target="docs" pivot="development-environment-azure-portal"

[!INCLUDE Clean-up Portal web app resources] :::zone-end

Next steps

.NET 10

Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:

[!div class="nextstepaction"] Tutorial: ASP.NET Core app with SQL database

[!div class="nextstepaction"] App Template: ASP.NET Core app with SQL database and App Insights deployed using CI/CD GitHub Actions

[!div class="nextstepaction"] Configure ASP.NET Core app

.NET Framework 4.8

Advance to the next article to learn how to create a .NET Framework app and connect it to a SQL Database:

[!div class="nextstepaction"] Tutorial: ASP.NET app with SQL database

[!div class="nextstepaction"] Configure ASP.NET Framework app

[!div class="nextstepaction"]  Secure with custom domain and certificate