AspNetCore.Docs/aspnetcore/getting-started/index.md

2.6 KiB

title author description ms.author ms.custom ms.date uid
Get started with ASP.NET Core rick-anderson A quick tutorial that creates and runs a simple Hello World app using ASP.NET Core. riande mvc 12/11/2018 getting-started

Tutorial: Get started with ASP.NET Core

This tutorial shows how to use the .NET Core command-line interface to create an ASP.NET Core web app.

You'll learn how to:

[!div class="checklist"]

  • Create a web app project.
  • Enable local HTTPS.
  • Run the app.
  • Edit a Razor page.

At the end, you'll have a working web app running on your local machine.

Web app home page

Prerequisites

Create a web app project

Open a command shell, and enter the following command:

dotnet new webapp -o aspnetcoreapp

Enable local HTTPS

Trust the HTTPS development certificate:

Windows

dotnet dev-certs https --trust

The preceding command displays the following dialog:

Security warning dialog

Select Yes if you agree to trust the development certificate.

macOS

dotnet dev-certs https --trust

The preceding command displays the following message:

Trusting the HTTPS development certificate was requested. If the certificate is not already trusted we will run the following command: 'sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain <<certificate>>'.
*This command might prompt you for your password to install the certificate on the system keychain.

Password:*

Enter your password if you agree to trust the development certificate.

Linux

See the documentation for your Linux distribution on how to trust the HTTPS development certificate.


Run the app

Run the following commands:

cd aspnetcoreapp
dotnet run

Browse to https://localhost:5001. Click Accept to accept the privacy and cookie policy. This app doesn't keep personal information.

Edit a Razor page

Open Pages/Index.cshtml and modify the page with the following highlighted markup:

[!code-cshtml]

Browse to https://localhost:5001, and verify the changes are displayed.

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

  • Create a web app project.
  • Enable local HTTPS.
  • Run the project.
  • Make a change.

To learn more about ASP.NET Core, see the introduction:

[!div class="nextstepaction"] xref:index