Host ASP.NET Core 3 with Apache Using Webmin

If you are using Webmin to administer your Linux box, here are the steps to run ASP.NET Core application with Apache.


  • Ubuntu 18.04 / 20.04
  • Webmin

I assume that you have setup your server, Webmin and everything is up and running.

Install .Net Core

Here is a compilation of commands to install the .Net Core 3.1 on Ubuntu 18.04 / 20.04. Following is a list of commands without any clutter and specific for Webmin / Virtualmin setup.

Open a terminal with sudo user and execute following command to register Microsoft key

Following commands are for Ubuntu 18.04

wget -q -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb 

Following commands are for Ubuntu 20.04

wget -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb 

Now install .Net Core 3.1 and ASP.NET Core 3.1

sudo add-apt-repository universe 
sudo apt-get install dotnet-runtime-3.1 
sudo apt-get install aspnetcore-runtime-3.1 

If you want to install other .Net Core version, follow the tutorial from Microsoft Docs to get the correct command.

Setup .Net Core Website

Using Webmin, create a new Virtual Server. It would create a new folder “/home/Your_Virtual_Server”. Here create a new folder called “netcore_ Your_Virtual_Server” and upload and configure your .Net Core application to this folder.

Using terminal, navigate to this folder and execute the following command to quickly verify if everything is working as expected or not.

cd "/home/Your_Virtual_Server/netcore_Your_Virtual_Server"
dotnet "YourApp.dll"

Above command runs the application on http://localhost:5000 address by default. You can press “Ctrl+C” to terminate this application but continue running the application and keep this terminal open.

Note: Typically .NET Core application runs on port 5000 but it is possible that your application or application file may contain code/settings which forces the application to run on different port. Above command will spit out the URL with port number on which the application is running. Make sure to use the correct URL and port number for the rest of the article.

Setup Apache Proxy Module

Make sure Apache Proxy module is enabled.

Go to Webmin > Servers > Apache Webserver on left hand side menu.

Click on “Global Configuration” tab > Configure Apache Modules.

Make sure following modules are enabled.

  • proxy
  • proxy_balancer
  • proxy_connect
  • proxy_fcgi
  • proxy_http

I don’t how which modules are really needed but above list is from my configuration.

If any of these modules are not enabled, tick/check those modules and click on “Enable Selected Modules” button at the bottom.

Return back to Global Configuration.

Top right corner shows a button to apply the changes. Click on the button and Apache will apply changes.

Note: Without applying Apache changes, reverse proxy will not work.

Setup Apache Virtual Host

While the dotnet core application is running, we want to setup Apache.

Go to Webmin > Servers > Apache Webserver on left hand side menu.

Click on “Global Configuration” tab > Edit Config Files > Select your Virtual Server Config file “/etc/apache2/sites-available/MyDomain.conf” from the list.

If you have non SSL and SSL both the sites enabled, you will see two <VirtualHost> tags – one for non SSL site and another for SSL site.

If you have setup non SSL to SSL redirection within <VirtualHost>, you need to change only SSL <VirtualHost>. Otherwise, you need to change for both <VirtualHost> tags.

Under <VirtualHost> tag, add following settings to use proxy

RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
ProxyPreserveHost On
ProxyPass /.well-known !
ProxyPass /
ProxyPassReverse /

Above settings sets the special header, excludes Let’s Encrypt SSL request and forwards all other requests to the dotnet core application running on

Save the changes and go back to the Apache Webserver screen.

Top right corner shows a button to apply the changes. Click on the button and Apache will apply changes.

Note: Without applying Apache changes, reverse proxy will not work.

Now try to visit your website in a browser and you will get response from dotnet core application.

At this moment, your dotnet core application is working as expected so now in existing terminal where you started the dotnet core application, press Ctrl+C to terminate the dotnet core application that was running.

Monitor the Application

In above portion, you have manually ran the application but now we want this application managed by Linux. For this, we need to create service.

Create a service file “/etc/systemd/system/kestrel-Your_Virtual_Server_APP.service” using Webmin. Change the file name “kestrel-Your_Virtual_Server_APP.service” as per your need.

Open the service file in Webmin and paste following text. Make change to the file as per your need

Description= Your_Virtual_Server_APP .Net Core 3.1 App

ExecStart=/usr/local/bin/dotnet /home/Your_Virtual_Server/netcore_Your_Virtual_Server/YourApp.dll
Restart service after 10 seconds if the dotnet service crashes:


In above text, change Description, WorkingDirectory, ExecStart, SyslogIdentifier and User as per your configuration.

Enable service by executing following command using sudo user at terminal

sudo systemctl enable kestrel-Your_Virtual_Server_APP.service

At this moment, your service is enable. Now go to Webmin > System > Bootup and Shutdown.

Here you will see your service in a list. Select your service by clicking on a checkbox. Go all the way down and click on “Start on Boot” in order to start this service on bootup. Again select this service and click on “Start” button to start your service.

You are all set and now your .net core application is happily running behind the Apache proxy.

If for any reason, you face any problem with starting the kestrel application, use the following command to get the log

sudo journalctl -fu kestrel-Your_Virtual_Server_APP.service --since today



9 responses to “Host ASP.NET Core 3 with Apache Using Webmin”

  1. Host ASP.NET Core 6 Application with Apache Using Webmin – Vishal Monpara

    […] If you are using Webmin to administer your Linux box, here are the steps to run ASP.NET Core 6 application with Apache. If you are interested in installing .Net Core 3, you may use this article. […]

  2. Uninstall .Net Core 3.1 From Ubuntu 18/20 – Vishal Monpara

    […] had installed .Net Core 3.1 application on my Ubuntu 18/20 server. As the .Net Core 6 was released recently, I upgraded the source code to .Net Core 6. Instead of […]

  3. Upgrade Ubuntu Server 18.04.x to 20.04.01 LTS On Digital Ocean – Vishal Monpara

    […] control panel for any indie developer who wants more control over the server. As an added benefit, I can run .Net Core application on the Linux server along with WordPress (PHP, MySQL), Apache, Kestrel (.Net Core Server), Email Server (Postfix, […]

  4. David Avatar

    Hi. I’m trying to do what you suggested but using the main website not a virtual site on my vps. I have a SSL certificate for that site and want to use that, so how different is it please?

    1. Vishal Monpara Avatar
      Vishal Monpara

      Hi David,

      Make sure that you have Apache proxy modules installed and enabled. In my configuration, I am using SSL only for outside connection. I am not using SSL between Apache and proxy. If you want SSL to connect from browser to your main site only and not from main site to proxy site, no additional SSL configuration is needed for proxy to work.

      Vishal Monpara

  5. Adam Avatar

    Hello! Vishal Monpara thanks for great guide.

    I have reached the stage “Setup Apache”. I have two virtual server. I go to Global Configuration > Edit Config Files > /etc/apache2/sites-available/MyDomain.conf. In this file i have two VirtualHost section:



    In first section i add your code from “Setup Apache” section. I reboot server and run .NET app. When i go to domain i got error ERR_CONNECTION_REFUSED

    1. Vishal Monpara Avatar
      Vishal Monpara

      Hi Adam,

      There may be couple of issues.

      • In MyDomain.conf typically there is one VirtualHost section for non SSL site and another one for SSL site. If you redirect Non SSL to SSL site, you need to setup reverse proxy only in SSL VirtualHost section. If you don’t redirect, you need to setup reverse proxy in both VirtualHost sections.
      • When you manually run the .Net Core application using command “dotnet “YourApp.dll”, make sure there is no error visible on terminal and keep it running. Don’t terminate the application.
      • Typically .Net Core application runs on port 5000 by default. If you have mentioned specific port within your application or application startup file, you need to use that port (and not port 5000 as mentioned in the article). When you run command “dotnet “YourApp.dll”, Terminal output shows the URL with port on which the .NET Core application is running.
      • Open a second Terminal and try to use “wget” command “wget“. (Make sure to use correct port number in the URL). Check if you get the output as you expected.

      Thank you
      Vishal Monpara

  6. Marcio Avatar

    Hello! How may I host two .net core application using Apache?

    I’ve tried to use two kestrel services (up and running) and two virtual hosts.

    First on 5000 port and second on 5001 port, but I have no success, both on 80 port.


    1. Vishal Monpara Avatar
      Vishal Monpara

      Hello Marcio,

      Once you create two separate services on port 5000 and port 5001, you need to setup two individual virtual servers. Both of these virtual servers are either separate domains or separate subdomains. Use each virtual server as a reverse proxy for your .net core application. This way, both virtual servers will run on port 80.

      Generally it is not a good idea to directly expose .net core application to outside world on port 5000 and 5001. But if you really need it that way, you need to open those ports within your server firewall.

      Vishal Monpara

Leave a Reply

Your email address will not be published. Required fields are marked *