2015-10-08 21:41:04 +00:00
# .NET Command Line Interface
2016-05-16 14:23:01 +00:00
[![.NET Slack Status ](https://aspnetcoreslack.herokuapp.com/badge.svg?2 )](http://tattoocoder.com/aspnet-slack-sign-up/) [![Join the chat at https://gitter.im/dotnet/cli ](https://badges.gitter.im/Join%20Chat.svg )](https://gitter.im/dotnet/cli?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2015-11-30 23:39:31 +00:00
2017-06-23 18:51:11 +00:00
This repo contains the source code for cross-platform [.NET Core ](http://github.com/dotnet/core ) command line toolchain. It contains the implementation of each command, the native packages for various supported platforms and the documentation.
2015-11-16 20:22:11 +00:00
2017-03-10 01:09:59 +00:00
Looking for V1 of the .NET Core tooling?
----------------------------------------
2017-04-13 14:43:53 +00:00
2017-08-29 04:18:43 +00:00
If you are looking for the v2.0 release of the .NET Core tools (CLI, MSBuild and the new csproj), head over to https://dot.net/core and download!
2016-06-02 14:20:23 +00:00
2018-02-21 00:26:45 +00:00
> **Note:** the master branch of the CLI repo is based on an upcoming update of the SDK and is considered pre-release. For production-level usage, please use the
2017-08-16 21:40:06 +00:00
> released version of the tools available at https://dot.net/core
2016-07-23 17:38:31 +00:00
2016-02-19 23:59:14 +00:00
Found an issue?
---------------
2017-06-27 21:53:41 +00:00
You can consult the [Documents Index ](Documentation/README.md ) to find out the current issues and to see the workarounds.
2016-02-19 23:59:14 +00:00
2017-03-28 13:50:05 +00:00
If you don't find your issue, please file one! However, given that this is a very high-frequency repo, we've setup some [basic guidelines ](Documentation/project-docs/issue-filing-guide.md ) to help you. Please consult those first.
2015-11-24 21:25:08 +00:00
2016-06-22 16:29:08 +00:00
This project has adopted the code of conduct defined by the [Contributor Covenant ](http://contributor-covenant.org/ ) to clarify expected behavior in our community. For more information, see the [.NET Foundation Code of Conduct ](http://www.dotnetfoundation.org/code-of-conduct ).
2015-10-21 22:47:45 +00:00
Build Status
------------
2018-03-25 19:48:16 +00:00
|Windows x64|Windows x86|macOS|Linux x64 Archive|Linux arm Archive|Linux arm64 Archive|Linux Native Installers|RHEL 6 Archive|Alpine 3.6 Archive|
|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|
|[![][win-x64-build-badge]][win-x64-build]|[![][win-x86-build-badge]][win-x86-build]|[![][osx-build-badge]][osx-build]|[![][linux-build-badge]][linux-build]|[![][linux-arm-build-badge]][linux-arm-build]|[![][linux-arm64-build-badge]][linux-arm64-build]|[![][linuxnative-build-badge]][linuxnative-build]|[![][rhel6-build-badge]][rhel6-build]|[![][alpine3.6-build-badge]][alpine3.6-build]|
2017-02-06 18:37:32 +00:00
2017-07-25 19:24:33 +00:00
[win-x64-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6902/badge
[win-x64-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=6902
2017-02-06 18:37:32 +00:00
2017-07-25 19:24:33 +00:00
[win-x86-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6901/badge
[win-x86-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=6901
2017-02-06 18:37:32 +00:00
2017-07-25 19:24:33 +00:00
[osx-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6900/badge
[osx-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=6900
2017-02-06 18:37:32 +00:00
2017-07-25 19:24:33 +00:00
[linux-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6899/badge
[linux-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=6899
2017-02-06 18:37:32 +00:00
2018-03-15 02:04:25 +00:00
[linux-arm-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/8721/badge
[linux-arm-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=8721
2018-03-25 19:48:16 +00:00
[linux-arm64-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/8817/badge
[linux-arm64-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=8817
2017-10-02 23:47:17 +00:00
[linuxnative-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/7254/badge
[linuxnative-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=7254
2017-02-06 18:37:32 +00:00
2017-10-02 23:47:17 +00:00
[rhel6-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/7392/badge
[rhel6-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=7392
2017-02-06 18:37:32 +00:00
2017-12-21 00:39:01 +00:00
[alpine3.6-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/8168/badge
[alpine3.6-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed& definitionId=8168
2017-03-09 23:48:29 +00:00
2016-03-30 22:01:41 +00:00
Installers and Binaries
-----------------------
2015-11-08 06:16:39 +00:00
2017-08-17 20:19:03 +00:00
You can download the .NET Core SDK as either an installer (MSI, PKG) or a zip (zip, tar.gz). The .NET Core SDK contains both the .NET Core runtime and CLI tools.
2016-03-30 22:01:41 +00:00
2017-08-17 20:19:03 +00:00
To download the .NET Core runtime **without** the SDK, visit https://github.com/dotnet/core-setup#daily-builds.
2016-03-30 22:01:41 +00:00
2017-08-17 20:19:03 +00:00
> **Note:** Be aware that the following installers are the **latest bits**. If you
> want to install the latest released versions, check out the [preceding section](#looking-for-v1-of-the-net-core-tooling).
2017-10-17 04:16:43 +00:00
> In order to be able to restore these pre-release packages, you may need to add a NuGet feed pointing to https://dotnet.myget.org/F/dotnet-core/api/v3/index.json. Other feeds may also be necessary depending on what kind of project you are working with.
2016-06-02 14:20:23 +00:00
2018-02-21 00:26:45 +00:00
| Platform | Latest Daily Build< br > *master*< br > [![][version-badge]][version] |
2017-03-20 22:09:21 +00:00
| -------- | :-------------------------------------: |
2017-02-06 18:37:32 +00:00
| **Windows x64** | [Installer][win-x64-installer] - [Checksum][win-x64-installer-checksum]< br > [zip][win-x64-zip] - [Checksum][win-x64-zip-checksum] |
| **Windows x86** | [Installer][win-x86-installer] - [Checksum][win-x86-installer-checksum]< br > [zip][win-x86-zip] - [Checksum][win-x86-zip-checksum] |
2017-09-19 22:59:00 +00:00
| **macOS** | [Installer][osx-installer] - [Checksum][osx-installer-checksum]< br > [tar.gz][osx-targz] - [Checksum][osx-targz-checksum] |
2018-02-26 23:51:09 +00:00
| **Linux x64** | [DEB Installer][linux-DEB-installer] - [Checksum][linux-DEB-installer-checksum]< br > [RPM Installer][linux-RPM-installer] - [Checksum][linux-RPM-installer-checksum]< br > _see installer note below_< sup > 1</ sup >< br > [tar.gz][linux-targz] - [Checksum][linux-targz-checksum] |
2018-03-15 02:04:25 +00:00
| **Linux arm** | [tar.gz][linux-arm-targz] - [Checksum][linux-arm-targz-checksum] |
2018-03-25 19:48:16 +00:00
| **Linux arm64** | [tar.gz][linux-arm64-targz] - [Checksum][linux-arm64-targz-checksum] |
2017-10-02 23:47:17 +00:00
| **RHEL 6** | [tar.gz][rhel-6-targz] - [Checksum][rhel-6-targz-checksum] |
2017-12-21 00:39:01 +00:00
| **Alpine 3.6** | [tar.gz][alpine-3.6-targz] - [Checksum][alpine-3.6-targz-checksum] |
2017-07-10 21:14:10 +00:00
2018-02-21 00:26:45 +00:00
| Latest Coherent Build< sup > 2< / sup > < br > *master* |
2017-07-10 22:13:40 +00:00
|:------:|
2017-07-10 22:15:54 +00:00
| [![][coherent-version-badge]][coherent-version] |
2017-07-10 22:11:19 +00:00
2017-07-10 21:14:10 +00:00
Reference notes:
2017-07-10 22:15:54 +00:00
> **1**: *Our Debian packages are put together slightly differently than the other OS specific installers. Instead of combining everything, we have separate component packages that depend on each other. If you're installing these directly from the .deb files (via dpkg or similar), then you'll need to install the [corresponding Host, Host FX Resolver, and Shared Framework packages](https://github.com/dotnet/core-setup#daily-builds) before installing the Sdk package.*
> <br><br>**2**: *A 'coherent' build is defined as a build where the Runtime version matches between the CLI and Asp.NET.*
2017-07-10 22:18:15 +00:00
2018-02-21 00:26:45 +00:00
[version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/latest.version
[coherent-version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/latest.coherent.version
2017-02-06 18:37:32 +00:00
[comment]: # (The latest versions are always the same across all platforms. Just need one to show, so picking win-x64's svg.)
2018-02-21 00:26:45 +00:00
[version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/win_x64_Release_version_badge.svg
[coherent-version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/win_x64_Release_coherent_badge.svg
2017-05-24 21:01:01 +00:00
2018-02-21 00:26:45 +00:00
[win-x64-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x64.exe
[win-x64-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x64.exe.sha
[win-x64-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x64.zip
[win-x64-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x64.zip.sha
2017-06-05 23:31:35 +00:00
2018-02-21 00:26:45 +00:00
[win-x86-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x86.exe
[win-x86-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x86.exe.sha
[win-x86-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x86.zip
[win-x86-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x86.zip.sha
2017-06-05 23:31:35 +00:00
2018-02-21 00:26:45 +00:00
[osx-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-osx-x64.pkg
[osx-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-osx-x64.pkg.sha
[osx-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-osx-x64.tar.gz
[osx-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-osx-x64.tar.gz.sha
2017-06-05 23:31:35 +00:00
2018-02-21 00:26:45 +00:00
[linux-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-linux-x64.tar.gz
[linux-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-linux-x64.tar.gz.sha
2017-06-01 21:25:12 +00:00
2018-03-15 02:04:25 +00:00
[linux-arm-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-linux-arm.tar.gz
[linux-arm-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-linux-arm.tar.gz.sha
2018-03-25 19:48:16 +00:00
[linux-arm64-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-linux-arm64.tar.gz
[linux-arm64-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-linux-arm64.tar.gz.sha
2018-02-21 00:26:45 +00:00
[linux-DEB-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-x64.deb
[linux-DEB-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-x64.deb.sha
2017-06-01 19:38:51 +00:00
2018-02-26 23:51:09 +00:00
[linux-RPM-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-x64.rpm
[linux-RPM-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-x64.rpm.sha
2017-06-01 19:38:51 +00:00
2018-02-21 00:26:45 +00:00
[rhel-6-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-rhel.6-x64.tar.gz
[rhel-6-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-rhel.6-x64.tar.gz.sha
2017-03-09 23:48:29 +00:00
2018-02-21 00:26:45 +00:00
[alpine-3.6-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-alpine.3.6-x64.tar.gz
[alpine-3.6-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-alpine.3.6-x64.tar.gz.sha
2017-06-19 21:15:48 +00:00
2017-04-18 19:01:07 +00:00
# Debian daily feed
Newest SDK binaries for 2.0.0 in debian feed may be delayed due to external issues by up to 24h.
## Obtaining binaries
2017-05-24 21:43:25 +00:00
### Add debian feed:
Ubuntu 14.04
2017-04-18 19:01:07 +00:00
```
sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ trusty main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
```
2017-05-24 21:43:25 +00:00
Ubuntu 16.04
```
sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
```
Debian 8
```
sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ jessie main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
```
### Install:
2017-04-18 19:01:07 +00:00
```
sudo apt-get install < DebianPackageName > =< Version >
```
2017-05-24 21:43:25 +00:00
### To list available packages:
2017-04-18 19:01:07 +00:00
```
apt-cache search dotnet-sdk | grep 2.0.0
```
2015-11-16 20:22:11 +00:00
Docker
------
2015-10-19 08:47:45 +00:00
2015-11-18 07:19:39 +00:00
You can also use our Docker base images found on https://hub.docker.com/r/microsoft/dotnet to set up your dev or testing environment for usage.
Basic usage
-----------
2015-12-31 17:38:04 +00:00
When you have the .NET Command Line Interface installed on your OS of choice, you can try it out using some of the samples on the [dotnet/core repo ](https://github.com/dotnet/core/tree/master/samples ). You can download the sample in a directory, and then you can kick the tires of the CLI.
2015-11-18 15:19:05 +00:00
2015-11-18 07:19:39 +00:00
First, you will need to restore the packages:
2017-04-07 20:06:08 +00:00
2017-05-24 21:43:25 +00:00
dotnet restore
2017-04-07 20:06:08 +00:00
2015-11-18 07:19:39 +00:00
This will restore all of the packages that are specified in the project.json file of the given sample.
Then you can either run from source or compile the sample. Running from source is straightforward:
2017-04-07 20:06:08 +00:00
2017-05-24 21:43:25 +00:00
dotnet run
2017-04-07 20:06:08 +00:00
2015-11-18 07:19:39 +00:00
Compiling to IL is done using:
2017-04-07 20:06:08 +00:00
2017-05-24 21:43:25 +00:00
dotnet build
2015-11-25 18:16:57 +00:00
2017-04-07 20:06:08 +00:00
This will drop an IL assembly in `./bin/[configuration]/[framework]/[binary name]`
2016-06-02 14:20:23 +00:00
that you can run using `dotnet bin/[configuration]/[framework]/[binaryname.dll]` .
2015-12-19 23:19:57 +00:00
2017-08-17 20:19:03 +00:00
For more details, refer to the [documentation ](https://aka.ms/dotnet-cli-docs ).
2015-11-25 18:16:57 +00:00
2015-11-27 17:02:31 +00:00
Building from source
--------------------
2017-04-07 20:06:08 +00:00
If you are building from source, take note that the build depends on NuGet packages hosted on MyGet, so if it is down, the build may fail. If that happens, you can always see the [MyGet status page ](http://status.myget.org/ ) for more info.
2016-01-11 17:51:43 +00:00
2016-06-07 16:42:05 +00:00
Read over the [contributing guidelines ](CONTRIBUTING.md ) and [developer documentation ](Documentation ) for prerequisites for building from source.
2016-02-25 09:58:24 +00:00
2015-11-16 20:22:11 +00:00
Questions & Comments
--------------------
2015-10-08 21:49:39 +00:00
2017-08-17 20:19:03 +00:00
For all feedback, use the Issues on this repository.
2016-03-30 23:42:25 +00:00
License
2016-10-27 23:02:05 +00:00
-------
2016-03-30 23:42:25 +00:00
2016-06-27 18:55:38 +00:00
By downloading the .zip you are agreeing to the terms in the project [EULA ](https://aka.ms/dotnet-core-eula ).