Intro
Purpose
Install .NET and create your first web application.
Prerequisites
None.
Time to Complete
10 minutes
Scenario
A web app that displays a Hello, World! message on a web page.
Download and install
To start building .NET apps you just need to download and install the .NET SDK (Software Development Kit).
Not running x64? You'll need to download the .NET Core binaries instead.
Enable .NET channel
In order to install .NET Core from Red Hat on RHEL, you first need to register using the Red Hat Subscription Manager. If this has not been done on your system, or if you are unsure, see the Red Hat Getting Started Guide.
Install the .NET SDK
After registering with the Subscription Manager and enabling the .NET Core channel, you are ready to install and enable the .NET SDK.
In your terminal, run the following commands:
Terminal
yum install rh-dotnet22 -y
scl enable rh-dotnet22 bashRegister Microsoft key and feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
wget -q https://packages.microsoft.com/config/ubuntu/19.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.debInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2If you receive an error message similar to Unable to locate package dotnet-sdk-2.2, run the following commands.
Terminal
sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2If that doesn't work, you can run a manual install with the following commands.
Terminal
sudo apt-get install -y gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/ubuntu/19.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2Register Microsoft key and feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.debInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo add-apt-repository universe
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2If you receive an error message similar to Unable to locate package dotnet-sdk-2.2, run the following commands.
Terminal
sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2If that doesn't work, you can run a manual install with the following commands.
Terminal
sudo apt-get install -y gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/ubuntu/18.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2Register Microsoft key and feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.debInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2If you later perform an in-place upgrade, you may get an error message similar to Unable to locate package dotnet-sdk-2.2 when trying to install/update .NET.
See Ubuntu 19.04 install instructions to learn how to fix this issue.
Register Microsoft key and feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/debian/9/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.listInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2Add the dotnet product feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo wget -q -O /etc/yum.repos.d/microsoft-prod.repo https://packages.microsoft.com/config/fedora/27/prod.repoInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo dnf update
sudo dnf install dotnet-sdk-2.2Add the dotnet product feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo wget -q -O /etc/yum.repos.d/microsoft-prod.repo https://packages.microsoft.com/config/fedora/27/prod.repoInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo dnf update
sudo dnf install dotnet-sdk-2.2Add the dotnet product feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpmInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo yum update
sudo yum install dotnet-sdk-2.2Add the dotnet product feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
sudo zypper install libicu
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
wget -q https://packages.microsoft.com/config/opensuse/42.2/prod.repo
sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo
sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repoInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo zypper update
sudo zypper install dotnet-sdk-2.2Add the dotnet product feed
Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
Terminal
sudo rpm -Uvh https://packages.microsoft.com/config/sles/12/packages-microsoft-prod.rpmInstall the .NET SDK
Update the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
Terminal
sudo zypper update
sudo zypper install dotnet-sdk-2.2Check everything installed correctly
Once you've installed, open a new command prompt and run the following command:
Once you've installed, open a new terminal and run the following command:
Command prompt
dotnetIf the command runs, printing out information about how to use dotnet, you're good to go.
If you receive a 'dotnet' is not recognized as an internal or external command error, make sure you opened a new command prompt. If you can't resolve the issue, use the I ran into an issue button to get help fixing the problem.
Create your app
In your command prompt, run the following commands:
In your terminal, run the following commands:
Command prompt
dotnet new webApp -o myWebApp --no-https
cd myWebAppWhat do these commands mean?
The dotnet new command creates a new application.
- The
webAppparameter selects what template to use when creating your app. - The
-oparameter creates a directory namedmyWebAppwhere your app is stored. - The
--no-httpsflag specifies not to enable HTTPS.
The cd myWebApp command puts you into the newly created app directory.
What files were created?
Several files were created in the myWebApp directory, to give you a simple web application that is ready to run.
Startup.cscontains all the settings and configurations.- The
myWebApp/Pagesdirectory contains some example web pages for the application. myWebApp.csprojdefines what libraries are referenced etc.
Run your app
In your command prompt, run the following command:
In your terminal, run the following command:
Command prompt
dotnet runOnce the command completes, browse to http://localhost:5000
Congratulations, you've built and run your first .NET web app!
Edit your code
Open Pages/Index.cshtml in any text editor and replace all of the code with the following:
Index.cshtml
@page
@model IndexModel
@{
ViewData["Title"] = "Home page";
}
<h1>Hello, world!</h1>
<p>The time on the server is @DateTime.Now</p>Save the file then refresh the browser to see the change:
Next steps
Now that you've got the basics, continue building your first ASP.NET app with Razor Pages.
You might also be interested in...
