This topic applies to .NET Core Tools Preview 2. For the .NET Core Tools RC4 version, see the dotnet-run (.NET Core Tools RC4) topic.
dotnet-run - Runs source code 'in-place' without any explicit compile or launch commands.
dotnet run [--help] [--framework] [--configuration]
[--project] [[--] [application arguments]]
dotnet run command provides a convenient option to run your application from the source code with one command.
It compiles source code, generates an output program and then runs that program.
This command is useful for fast iterative development and can also be used to run a source-distributed program (for example, a website).
This command relies on dotnet build to build source inputs to a .NET assembly, before launching the program. The requirements for this command and the handling of source inputs are all inherited from the build command. The documentation for the build command provides more information on those requirements.
Output files are written to the child bin folder, which will be created if it doesn't exist. Files will be overwritten as needed. Temporary files are written to the child obj folder.
In case of a project with multiple specified frameworks,
dotnet run will first select the .NET Core frameworks. If those do not exist, it will error out. To specify other frameworks, use the
dotnet run command must be used in the context of projects, not built assemblies. If you're trying to run a portable application DLL instead, you should use dotnet without any command like in the following example:
For more information about the
dotnet driver, see the .NET Core Command Line Tools (CLI) topic.
Delimits arguments to
dotnet run from arguments for the application being run.
All arguments after this one will be passed to the application being run.
Prints out a short help for the command.
Runs the application for a given framework identifier (FID).
Configuration to use when publishing. The default value is
Run the project in the current directory:
Run the specified project:
dotnet run --project /projects/proj1/project.json
Run the project in the current directory (the
--help argument in this example is passed to the application being run, since the
-- argument was used):
dotnet run --configuration Release -- --help