.NET Core 2.0 - How to publish a self-contained application

Article
03/19/2017

If you are new with .NET Core 2.0, please take a look at the post .NET Core 1.1 – Where to Start first.

I am assuming you already have an ASP.NET MVC application created and build. If you don’t have, please check the following post: NET Core 1.1 – Creating an ASP.NET Core using the .NET CLI for details about how to create an ASP.NET Core MVC application.

The idea of this post is to show you how to create a self-contained application that does not requires that the .NET SDK be installed on the target machine.

The first thing that we need to do is to edit the .csproj file, in my case the HelloWorld.csproj, to include the runtimes. By default, the .csproj is created as follows:

If I want to publish a self-contained version of my application to Windows, for example, all I have to do is to modify the .csproj including the following line:

 
<RuntimeIdentifiers>win10-x64</RuntimeIdentifiers>

After saved the changes, it is necessary to run the following command to restore the dependencies:

dotnet restore

To generate the self-contained application, run the following command:

dotnet publish -c release -r win10-x64

As I am using the runtime Win10-x64, the outcome files will be generated inside the folder win10-x64\publish:

Observe that this time, the application was build with the .exe extension instead of .dll. If you open up the web.config of this publish folder, you will notice that this file does not refers to the dotnet.exe anymore:

Now, lets suppose that you would like to publish to MAC or Linux. In this case, all you need to do is to add the following runtime to the .csproj file:

<RuntimeIdentifiers>win10-x64;osx.10.11-x64;ubuntu.16.10-x64</RuntimeIdentifiers>

And restore again the dependencies of your project:

dotnet restore

Also, you need to inform the runtime target during the publish:

dotnet publish -c release -r ubuntu.16.10-x64

dotnet publish -c release -r osx.10.11-x64

If the machine that you want to run the self-contained application does not have the .NET Runtime, and if you decided to use IIS to host your application, in this case like a reverse-proxy, you have to install the .NET Core Module for IIS that is available at ASP.NET Core Server Hosting Bundle.

I hope you liked it.

Regards,

Comments

Anonymous
March 29, 2017
I came here to look for how to run an application. I did the publish from VS2017 and i assume it did all this for me. But how do you actually run it?
- Anonymous
  April 02, 2017
  Hi Mario,There are some options to running your application.1) You can run from VS2017 by pressing F5 to debug you application.2) After publishing to IIS, for example, you can browse the URL http://localhost/ followed by the name of you application (virtual directory)3) You can open the cmd, navigate to you app solution folder and type: dotnet runAfter that, all you have to do is access you application through http://localhost:5000/ followed by the name of your application.
  - Anonymous
    July 17, 2018
    HI Luís Henrique Demetrio,how could i change the port number from 5000 to any other like 8089
    - Anonymous
      July 19, 2018
      You can use the UseUrls method of WebHostBuilder or you can configure the server address using the configuration.Please check the following documentation for more information:https://docs.microsoft.com/en-us/aspnet/core/fundamentals/host/web-host?view=aspnetcore-2.1#server-urls
Anonymous
March 30, 2017
Quick question. Can I publish to Ubuntu or osx from a Windows machine and vice versa?
- Anonymous
  April 02, 2017
  Yes, All you have to do is publish informing the runtime (Win10-x64, osx.10.11-x64 or ubuntu.16.10-x64). After that, you need to use a tool of you preference to copy the files.
Anonymous
May 06, 2017
The comment has been removed
- Anonymous
  May 07, 2017
  The comment has been removed
  - Anonymous
    May 10, 2017
    Hi Luis, The problem about not generating the exe file, was the uppercaseJust in case, to help somebody else with the same issue:correct: dotnet publish -c release -r win10-x64incorrect: dotnet publish -c release -r Win10-x64Please correct the code above (with the screenshots)Best Regards,Marcelo
    - Anonymous
      May 10, 2017
      Thank you so much for let me know about that. :)I will fix that immediately.
Anonymous
May 09, 2017
They really need to make it easier to select the runtime. These XML tags are so arbitrary and not documented at all in the CLI documentation. Thank you for explaining it.
Anonymous
May 14, 2017
Hi Luís Henrique,Hope you will be very fine, I have one question regarding deploying it on hosting server through ftp. What actually published is exe file and I dont understand how can I deploy standalone package on server with IIS support.RegardsSyed Raza
- Anonymous
  May 14, 2017
  Thanks for your question.In this case, all you have to do is copy the content where your application was published (i.e., dotnet -c realease -r win10-x64) to the IIS application virtual directory. In this case, the IIS will act as a reverse-proxy, where w3wp.exe process will call your application binary. Take a look inside the web.config (after published) to see how it works.I hope have helped.Regards
Anonymous
May 24, 2017
Hi Luis,Thanks for all this. My question has to do with the very last paragraph. The machine I want to run the self-contained application on belongs to someone else, (godaddy)). I have a windows, shared-hosting account with them, and so I expect to use IIS by default.They have not installed anything for asp.net core on their servers. Is the ASP.NET Core Server Hosting Bundle something I need to install on my machine or does it need to go on the server?Thanks!Dan
- Anonymous
  May 25, 2017
  It's on the server.
Anonymous
May 25, 2017
Have you tried this Console app(.net core). It is not so easy as this... :(
- Anonymous
  May 25, 2017
  The steps is the same. Please, double-check that you are using the following command:dotnet publish -c release -r win10-x64The executable file will be at:\bin\release\netcoreapp1.1\win10-x64
Anonymous
July 03, 2017
I published to centos.7-x64 succesfully. Then how can I deploy it to the centos server with Nginx ? I uploaded all files to the server and run dotnet run (or dotnet run myapp) => Couldn't find a project to run. Ensure a project exists in /var/www/myapp. Or pass the path to the project using --project
- Anonymous
  July 19, 2018
  Sorry the huge delay to answer you! After one year, I realized that I missed this question. I believe that you already have the answer, but I will post the link here anyway in case it can be useful to anyone else:https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/linux-nginx?view=aspnetcore-2.1&tabs=aspnetcore2x
Anonymous
November 09, 2017
As the identifier is w10-x64, if I understand well it means it will run on Windows 10 only, right? or not?What about if I would like that the generated application be able to run on Windows 8 and 7 as well?Thank you
- Anonymous
  November 09, 2017
  The comment has been removed
Anonymous
May 02, 2018
Just have to say thank you! It really helped me a lot!
- Anonymous
  July 19, 2018
  Thank you!
Anonymous
July 05, 2018
Hi,I have one question related to Self contain deployment.My project have two console applications project named "CosoleApp1" and "ConsoleApp2".When I publish project the relevant publish folder created inside individual project folder along with "ConsoleApp1.exe" and "ConsoleApp2.exe".So now my question is how to publish solution so all the executables for all project will remain in one common folder so we need to pick only that folder in Self contain package.Thanks,
Anonymous
September 05, 2018
Thank you Luis,i followed the instructions and it works like a charm on windows 10. but then i copied the files to the windows server 2008, and it says: “-ms-win-crt-runtime-l1-1-0.dll was not found”. i suspect if .net core is not compitable for windows server 2008?
- Anonymous
  September 11, 2018
  Hi Ali.If you published as self-hosted you don't need to install anything and it will work. But if it is an ASP.NET Core App and if you are trying to host on IIS, you will need to install the ASP.NET Core Server Hosting Bundle on the server that is available at https://go.microsoft.com/fwlink/?linkid=837808.Let me know if it helped.
Anonymous
November 23, 2018
hi , i published succesfully but the same time routing static files in wwwroot folder get 404 not found statuse code !not : I have been Added app.UseStaticFiles();
- Anonymous
  November 23, 2018
  The comment has been removed
  - Anonymous
    November 23, 2018
    Thanks for your answer, You were right I was making a mistake, I have been added App.useStaticFiles() after app.useMvc ()another question : how can I Change Default Startup URL Address(https://localhost:5001) and bind to my server IP Address
    - Anonymous
      November 23, 2018
      before mark it as spam , i have been reading your another answer ,thanks
      - Anonymous
        November 23, 2018
        I am glad that it worked.Please let me know if the following post helps you about the URL question:https://docs.microsoft.com/en-us/aspnet/core/fundamentals/host/web-host?view=aspnetcore-2.1#server-urls
      - Anonymous
        November 26, 2018
        Hi againPlease forgive me for the weakness in EnglishThat's awesome, open the specific port in the firewall and call the program with ip addreess, but many times trying to run the application, the program crashed, I finally found the problems:The program may crash in the following cases:Listen to a port like 80.Use HTTPS on UseUrls (....)here , my first selef-containd .net core web App, thanks to microsft :http://185.2.14.88:5000/
Anonymous
March 18, 2019
The comment has been removed
- Anonymous
  May 16, 2019
  The comment has been removed
Anonymous
April 17, 2019
The comment has been removed

Partager via

.NET Core 2.0 - How to publish a self-contained application

Comments

Ressources supplémentaires