267

I have a .NET Core console application and have run dotnet publish. However, I can't figure out how to run the application from the command line. Any hints?

1

9 Answers 9

339

If it's a framework-dependent application (the default), you run it by dotnet yourapp.dll.

If it's a self-contained application, you run it using yourapp.exe on Windows and ./yourapp on Unix.

For more information about the differences between the two app types, see the .NET Core Application Deployment article on .NET documentation.

16
  • 30
    Its amazing how long it took me to find this out. I am trying all kinds of "dotnet run" commands, etc. This is the first place that I have come across in a lot of searching that gives the correct dotnet usage for running a console application. Why did Microsoft make .NET Core so un-developer friendly? Mar 21, 2017 at 10:25
  • 3
    @GlenThomas If you want to run an application you're developing, you use dotnet run. Also, where did you look? Where would you expect this information?
    – svick
    Mar 21, 2017 at 12:07
  • 3
    @GlenThomas That's not true, dotnet run works the same for the new csproj projects as it did for project.json.
    – svick
    Mar 21, 2017 at 16:30
  • 5
    @GlenThomas, not sure if this is the problem you were having, but when you try to use dotnet run, make sure you're in the project directory, not the solution directory.
    – Ryan Lundy
    Dec 12, 2018 at 9:52
  • 2
    @DavidA.Gray A lot can change in 3 years.
    – svick
    Aug 24, 2020 at 21:20
53

You can very easily create an EXE (for Windows) without using any cryptic build commands. You can do it right in Visual Studio.

  1. Right click the Console App Project and select Publish.
  2. A new page will open up (screen shot below)
  3. Hit Configure...
  4. Then change Deployment Mode to Self-contained or Framework dependent. .NET Core 3.0 introduces a Single file deployment which is a single executable.
  5. Use "framework dependent" if you know the target machine has a .NET Core runtime as it will produce fewer files to install.
  6. If you now view the bin folder in explorer, you will find the .exe file.
  7. You will have to deploy the exe along with any supporting config and dll files.

Console App Publish

4
  • 6
    Yep. There's the EXE - along with 217 other files (api-ms-win-core-namedpipe-l1-1-0.dll, etc). Is there anyway to bundle this down to a single EXE?
    – Elton
    Jan 9, 2019 at 16:35
  • 1
    Good question @Elton. I don' know. AFAIK you have to deploy all the dlls.
    – Jess
    Jan 10, 2019 at 13:15
  • 2
    I would think the fact that it is configured to be self-contained would require all of those DLLs to be there. If you don't want them there, the deployment mode would probably need to be Framework Dependent
    – kippermand
    Feb 21, 2019 at 18:51
  • 1
    You made my Friday! Aug 30, 2019 at 13:57
25

You can also run your application like any other console applications, but only after the publish.

Let's suppose you have the simple console application named MyTestConsoleApp.

Open the package manager console and run the following command:

dotnet publish -c Debug -r win10-x64 

The -c flag mean that you want to use the debug configuration (in other case you should use Release value)

The -r flag means that your application will be run on the Windows platform with an x64 architecture.

When the publish procedure will be finished you will see the *.exe file located in your bin/Debug/publish directory.

Now you can call it via command-line tools. So open the CMD window (or terminal) move to the directory where your *.exe file is located and write the next command:

>> MyTestConsoleApp.exe argument-list

For example:

>> MyTestConsoleApp.exe --input some_text -r true
5

With .NET Core 3.0 you can package the entire solution into a single-file executable using the PublishSingleFile property:

-p:PublishSingleFile=True

Source: Single-file executables

An example of a self-contained, release OS X executable:

dotnet publish -c Release -r osx-x64 -p:PublishSingleFile=True --self-contained True

An example of a self-contained, debug Linux 64-bit executable:

dotnet publish -c Debug -r linux-x64 -p:PublishSingleFile=True --self-contained True

The Linux build is independent of distribution and I have found them working on Ubuntu 18.10 (Cosmic Cuttlefish), CentOS 7.7, and Amazon Linux 2.

A self-contained executable includes the .NET runtime and runtime does not require to be installed on a target machine. The published executables are saved under:

<ProjectDir>/bin/<Release or Debug>/netcoreapp3.0/<target-os>/publish/ on Linux, OS X and

<ProjectDir>\bin\<Release or Debug>\netcoreapp3.0\<target-os>\publish\ on Windows.

1
  • You can also add the config to csproj file : <PublishSingleFile>true</PublishSingleFile> Dec 15, 2019 at 6:27
3

Using CMD you can run a console .NET Core project if .NET Core SDK is installed on your machine:

To run a console project using the Windows command-Line, choose the specific path from your directory and type the following below command:

dotnet run
3

Go to ...\bin\Debug\net5.0 ("net5.0" can also be something like "netcoreapp2.2", depending on the framework you use.)

Enter image description here

Open a PowerShell window by clicking on it like shown in the picture.

Type in the PowerShell window: .\yourApp.exe

You don't need dotnet publish. Just make sure you build it before to include all changes.

0

If it's a framework-dependent application (the default), you run it by dotnet yourapp.dll.

Folder Path :- Bin\Debug\net5.0

Steps ;_

  1. Cd and paste path 2)run dotnet yourapp.dll.

My Application Path : C:\Projects\CallLetter\CallLetterConsoleApp\CallL etterConsoleApp\bin\Debug\net5.0

0
  1. Open a command prompt or terminal window.
  2. Navigate to the directory that contains the compiled executable file of your .NET Core console application. The executable file has a .exe extension.
  3. Use the dotnet command followed by the name of the executable file to run the application. For example, if your executable file is named "MyApp.exe", the command would be:

dotnet MyApp.exe

  1. Press Enter to execute the command.
  2. Your .NET Core console application will start running, and you will see the output in the command prompt or terminal window.

That's it! Your .NET Core console application is now running from the command line. 😉

-1

Before you run in a command prompt, make sure "appsettings.json" has the same values as "appsettings.Development.json".

In a command prompt, go all the way to the bin/debug/netcoreapp2.0 folder. Then run "dotnet applicationname.dll"

1
  • There is a reason why these two files don't have the same values. It's much simpler to add "--environment development" to the dotnet run command
    – Stephane
    Nov 27 at 10:44

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.