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

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	05/31/2018	getting-started

Get started with ASP.NET Core

::: moniker range=">= aspnetcore-2.1"

1. Install the [!INCLUDE].

2. Create an ASP.NET Core project. Open a command shell and enter the following command:

   dotnet new webapp -o aspnetcoreapp
   

   [!INCLUDE]

3. Trust the HTTPS development certificate:

Windows

```console
dotnet dev-certs https --trust
```

The preceding command displays the following dialog:

![Security warning dialog](_static/cert.png)

Select **Yes** if you agree to trust the development certificate.

macOS

```console
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

---

4. Run the app:

   cd aspnetcoreapp
   dotnet run
   

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

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

   [!code-cshtml]

7. Browse to http://localhost:5001/About and verify the changes are displayed.

[!INCLUDEnext steps]

::: moniker-end

::: moniker range="= aspnetcore-2.0"

1. Install the [!INCLUDE].

2. Create a new ASP.NET Core project.

   Open a command shell. Enter the following command:

   dotnet new razor -o aspnetcoreapp
   

3. Run the app with the following commands:

   cd aspnetcoreapp
   dotnet run
   

4. Browse to http://localhost:5000.

5. Open Pages/About.cshtml and modify the page to display the message "Hello, world! The time on the server is @DateTime.Now":

   [!code-cshtml]

6. Browse to http://localhost:5000/About and verify the changes.

[!INCLUDEnext steps]

::: moniker-end

::: moniker range="<= aspnetcore-1.1"

1. Install the .NET Core SDK Installer for SDK 1.0.4 from the .NET Core All Downloads page.

2. Create a folder for a new ASP.NET Core project.

   Open a command shell. Enter the following commands:

   mkdir aspnetcoreapp
   cd aspnetcoreapp
   

3. If you have installed a later SDK version on your machine, create a global.json file to select the 1.0.4 SDK.

   {
     "sdk": { "version": "1.0.4" }
   }
   

4. Create a new ASP.NET Core project.

   dotnet new web
   

5. Restore the packages.

   dotnet restore
   

6. Run the app.

   dotnet run
   

   The dotnet run command builds the app first, if needed.

7. Browse to http://localhost:5000.

[!INCLUDEnext steps] ::: moniker-end