dotnet-installer/README.md

.NET Command Line Interface

This repo contains the source code for cross-platform .NET Core command line toolchain. It contains the implementation of each command, the native packages for various supported platforms as well as documentation.

New to .NET CLI?

Check out our Getting started page.

Release schedule

There have been some changes in the schedule for .NET Core and .NET Core CLI tools. You can read more about them in the .NET Core RC2 – Improvements, Schedule, and Roadmap blog post.

Found an issue?

You can consult the known issues page to find out the current issues and to see the workarounds.

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 to help you. Please consult those first.

Build Status

Ubuntu 14.04	Debian 8.2	Windows x64	Windows x86	Mac OS X	CentOS 7.1	RHEL 7.2	Ubuntu 16.04	OpenSUSE 13.2	Fedora 23

Installers and Binaries

You can download .NET Core as either an installer (MSI, PKG) or a zip (zip, gzip). You can download the product in two flavours:

• .NET Core - .NET Core runtime and framework
• .NET Core SDK - .NET Core + CLI tools

	Version	.NET Core Installer	.NET Core SDK Installer	.NET Core Binaries	.NET Core SDK Binaries
Windows x64		Download	Download	Download	Download
Windows x86		Download	Download	Download	Download
Ubuntu 14.04		See Below	See Below	Download	Download
Debian 8.2		N/A	N/A	Download	Download
Mac OS X		Download	Download	Download	Download
CentOS 7.1		N/A	N/A	Download	Download
RHEL 7.2		N/A	N/A	Download	Download
Ubuntu 16.04		N/A	N/A	Download	Download
openSUSE 13.2		N/A	N/A	Download	Download
Fedora 23		N/A	N/A	Download	Download

Ubuntu Installers

Our Debian packages are put together slightly differently than the other OS specific installers. Instead of combining everything, we have three 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 them in the order presented below.

**For Ubuntu 14.04

	Version	Installers
Shared Host		Download	Download
Shared Framework		Download	Download
Sdk		Download	Download

Interested in .NET Core + ASP.NET Core 1.0 RC1 bits?

This toolchain is independent from the DNX-based .NET Core + ASP.NET Core 1.0 RC1 bits. If you are looking for .NET Core + ASP.NET Core 1.0 RC1 bits, you can find instructions on the http://get.asp.net/.

Undoing documentation changes to include ubuntu16.04. Will add it back once we have VSO builds running happily and producing binaries for it.

Docker

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

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. You can download the sample in a directory, and then you can kick the tires of the CLI.

First, you will need to restore the packages:

dotnet restore

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:

dotnet run

Compiling to IL is done using:

dotnet build

This will drop a binary in ./bin/[configuration]/[framework]/[rid]/[binary name] that you can just run.

For more details, please refer to the documentation.

Building from source

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 for more info.

Read over the contributing guidelines and developer documentation for prerequisites for building from source.

Questions & Comments

For any and all feedback, please use the Issues on this repository.

License

By downloading the .zip you are agreeing to the terms in the project EULA.