Popular blog tags


In this tutorial you’ll set up and deploy a production-ready ASP.NET Core application with a MongoDb Server on Ubuntu 18.04 using Nginx.

How it works

Remember the relationships.

OS/ ubuntu server 18.04-x64 Solution Folder

OS---------- ubuntu server 18.04-x64 
 ├── .NET SDK & .NET  Runtime
 │   ├── .NET SDK                     <- ---------- SDK
 │   ├── .NET Runtime               <- ---------The .NET Runtime enables you to run existing  console app.
 │   ├── ASP.NET Core Runtime    <--- The ASP.NET Core Runtime enables you to run existing web/server applications.
 │   ├── .NET Desktop Runtime           <---(net5.0-windows) ,These TFMs represent OS-specific flavors of .NET 5 that include net5.0 plus OS-specific functionality.
 │   ├── net6.0-ios            <--- These TFMs represent OS-specific flavors of .NET 5 that include net5.0 plus OS-specific functionality.
 │   └──net6.0-android                   <--- These TFMs represent OS-specific flavors of .NET 5 that include net5.0 plus OS-specific functionality.
 ├── ASP.NET Core  web applications   <---- Listens on http://locahost:5000
 │   ├── nongodb server
 │   └── redis server
 └── Nginx web server   <--- Listens on Port 443 / 80 and forwards HTTP/S calls to http://locahost:5000.

One Ubuntu 18.04 server - Your server

ASP.NET Core Web Application - Runs your app / website on  Ubuntu 18.04 server
nginx - Listens on Port 443 / 80 and forwards HTTP/S calls to your website.

A secured Nginx web server
Mongodb Redis - Keeps your app data
Supervisor - Keeps your app running


Table of contents


Register Microsoft key and feed
Install the .NET Core  Runtime
Install the .NET SDK

Create a new ASP.NET Core web application
Publish and copy over the app
Install Monodb
Install nginx as reverse proxy
Configure SSL
Configure nginx
Monitoring the app


Prepare an  Run Evironmentn for ASP.NET Core Application on Ubuntu

Install the .NET Core 5.x Runtime <--an  Run Evironmentn for ASP.NET Core Application on Ubuntu
Install the .NET Core 5.x SDK        <--an  Run Evironmentn for ASP.NET Core Application on Ubuntu

Prepare an ASP.NET Core Website

insall web <--Running an ASP.NET Core Website on Ubuntu

install mongodb

install redis


insall nginx

Configure NGINX<--Configure NGINX as a Reverse Proxy to ASP.NET Core

install https<--Configure the reverse proxy for secure (HTTPS) client connections


buy domain

part one:Prepare an  Run Evironmentn for ASP.NET Core Application on Ubuntu

step 1.Setting up a Linux host


Linux Distribution

   ubuntu 18.04-x64

   root permissions

2.One Ubuntu 18.04 server

There are many service providing offering a cheap Linux based VPS (virtual private server). vultr.com offers  a single core, 1GB RAM instance for  about 5 USD/month. The instance we select is an Ubuntu Server 18.04 *64 LTS (HVM) with 8GB of storage (SSD).

3.NET  5.0 - Supported OS versions

.NET Core 5.0 is supported on the following Linux distributions/versions:

Ubuntu OS Version:  20.10, 20.04, 18.04, 16.04

For information on  Linux distributions supported by ASP.NET Core, see Prerequisites for .NET Core on Linux.



step 2. connect to this instance through SSH

1.On a Windows machine, you can use mRemoteNG to connect to a Linux machine. 

2.PuTTY: a free SSH and Telnet client


3.Xshell6 https://www.netsarang.com/en/all-downloads/

4.Termius SSH:https://www.termius.com/windows


step 3.Prepare an  Run Evironmentn for ASP.NET Core Application on Ubuntu

Prepare ASP.NET Projects

Initial Server Setup with Ubuntu 18.04 

How To Install Nginx on Ubuntu 18.04


Install winscp on windows


文件传输协议 = SFTP-3
加密协议 = SSH-2
SSH实现 = OpenSSH_7.2p2 Ubuntu-4ubuntu2.4
加密算法 = aes
压缩 = 否


other tools:

SecureCRT+SecureFX  https://www.portablesoft.org/securecrt-securefx-legacy-versions/


# lsb_release -a

LSB Version:	core-9.20170808ubuntu1-noarch:security-9.20170808ubuntu1-noarch
Distributor ID:	Ubuntu
Description:	Ubuntu 18.04.3 LTS
Release:	18.04
Codename:	bionic


Install using deb/rpm packages

step 1:Try purging the package list:


sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update


Removing packages-microsoft-prod (1.0-ubuntu18.04.2) ...
Purging configuration files for packages-microsoft-prod (1.0-ubuntu18.04.2) ..

step 2:Run a manual install with the following commands:

First, download a binary release for either the SDK or the runtime from one of the following sites:

Open a terminal and run the following commands:

sudo apt-get install -y gpg
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/ubuntu/{os-version}/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 update
  sudo apt-get install -y apt-transport-https 
  sudo apt-get update 
  sudo apt-get install -y sudo apt-get install -y gpg

sudo apt-get install dotnet-sdk-5.0
sudo apt-get install aspnetcore-runtime-5.0


 % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
100  6356  100  6356    0     0   9067      0 --:--:-- --:--:-- --:--:-- 16682

step 3:Run the script

sudo apt-get update
  sudo apt-get install -y apt-transport-https && 
  sudo apt-get update 
  sudo apt-get install -y dotnet-sdk-5.0



step 3.Check everything installed correctly

To make sure it works after you’ve set it up, just run:

#dotnet --info

.NET SDK (reflecting any global.json):
 Version:   5.0.100-rc.2.20479.15
 Commit:    da7dfa8840

Runtime Environment:
 OS Name:     ubuntu
 OS Version:  18.04
 OS Platform: Linux
 RID:         ubuntu.18.04-x64
 Base Path:   /usr/share/dotnet/sdk/5.0.100-rc.2.20479.15/

Host (useful for support):
  Version: 5.0.0-rc.2.20475.5
  Commit:  c5a3f49c88

.NET SDKs installed:
  3.0.100 [/usr/share/dotnet/sdk]
  3.1.301 [/usr/share/dotnet/sdk]
  5.0.100-rc.2.20479.15 [/usr/share/dotnet/sdk]

.NET runtimes installed:
  Microsoft.AspNetCore.App 3.0.0 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]
  Microsoft.AspNetCore.App 3.1.5 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]
  Microsoft.AspNetCore.App 5.0.0-rc.2.20475.17 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]
  Microsoft.NETCore.App 3.0.0 [/usr/share/dotnet/shared/Microsoft.NETCore.App]
  Microsoft.NETCore.App 3.1.5 [/usr/share/dotnet/shared/Microsoft.NETCore.App]
  Microsoft.NETCore.App 5.0.0-rc.2.20475.5 [/usr/share/dotnet/shared/Microsoft.NETCore.App]

To install additional .NET runtimes or SDKs:

If the command runs, printing out information about dotnet, you're good to go.

step 4:Website Creation

#mkdir myapp
#cd myapp
#dotnet new mvc -o test
#cd test
The template "ASP.NET Core Empty" was created successfully.

Processing post-creation actions...
Running 'dotnet restore' on test1/test1.csproj...
  Restore completed in 1.03 sec for /root/myapp/test1/test1.csproj.

Restore succeeded.

The dotnet command creates a new website server application of type website for you. The -o parameter creates a directory named test where your app is stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

step5:Run the app

Kestrel is the web server that is included by default in ASP.NET Core new project templates. It is a cross-platform web server for ASP.NET Core based on libuv, a cross-platform asynchronous I/O library. If your application accepts requests only from an internal network, you can use Kestrel by itself.



dotnet run --urls http://localhost:5005



dotnet run --urls
warn: Microsoft.AspNetCore.Server.Kestrel[0]
      Unable to bind to http://localhost:5005 on the IPv6 loopback interface: 'Cannot assign requested address'.
Hosting environment: Development
Content root path: /root/myapp/test
Now listening on: http://localhost:5005
Application started. Press Ctrl+C to shut down.


step 5:Test the Application Directly on Kestrel Server

navigate to http://<serveraddress>:<port> to verify the app works on Linux locally.

visit http://localhost:5000/。,open another terminal

wget http://localhost:5000/


We use the following command to list the available releases of .NET Core on Linux host.

apt-cache search dotnet


Configure ASP.NET Core as a Background Service

 We will use systemd and create a service file to start and monitor the underlying web app. systemd is an init system that provides many powerful features for starting, stopping and managing processes.

We can create a configuration file using the following command

sudo vi /etc/systemd/system/kestrel-wwwstocksocom.service

The content of the .sevice file is as follows.

Description=www.stockso.com App running on Ubuntu

ExecStart=/usr/bin/dotnet /var/www/nopcommerce/wwwstocksocom/src/Presentation/Nop.Web/bin/release/netcoreapp3.0/publish/Nop.Web.dll --urls
# Restart service after 10 seconds if the dotnet service crashes:
User=www-data  #以www-datar的身份启动


If you completed the configuration and save the .service file, you need to reload and enable it.

first,reload kestrel-wwwstocksocom.service

sudo systemctl daemon-reload 

Reload systemd manager configuration. This will rerun all generators (see systemd.generator(7)), reload
       all unit files, and recreate the entire dependency tree. While the daemon is being reloaded, all sockets
       systemd listens on behalf of user configuration will stay accessible.

second enable it.

sudo systemctl enable kestrel-wwwstocksocom.service

then start it.

sudo systemctl start kestrel-wwwstocksocom.service
sudo systemctl restart kestrel-wwwstocksocom.service


sudo systemctl status kestrel-wwwstocksocom.service


sudo journalctl -fu kestrel-wwwstocksocom.service


在你的Linux 里确认 8045 处于 Listen 状态用命令: netstat -tlanp | grep 8045

端口范围  80/80






1.dotnet publish

2.copy in\Debug\netcoreapp2.1\publish\*.* to linux  var/www/

3.cd var/www/publish

4.dotnet project.dll



Prerequisites for .NET Core on Linux


Microsoft Host ASP.NET Core 3.x on Linux with Nginx


Debug Linux core dumps in Visual Studio