Select your environment

Select your Linux distro

Select your environment

This is an early preview and we are encouraging feedback. It is recommended that you do not install this on a production machine. Please see the .NET Team blog for details on new features, read the release notes, and visit our GitHub repo for more downloads.

.NET Core 1.1 is the latest stable version. Please see these install instructions to install the stable version.

Install for Windows

  1. 1

    Install .NET Core 2.0 Preview 2

    To start evaluating the latest preview of .NET Core, download the .NET Core 2.0 preview for Windows.

    Download .NET Core 2.0 Preview 2
  2. 2

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  3. 3

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  4. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

  5. Try Visual Studio 2017 Preview version 15.3

    Try out Visual Studio 2017 Preview version 15.3 to evaluate new features for apps built with .NET Core 2.0 Preview 2.

    Try Visual Studio 2017 Preview version 15.3

Install for CentOS 7.1 (64 bit) & Oracle Linux 7.1 (64 bit)

  1. 1

    Install .NET Core 2.0 Preview 2

    Before you start, please remove any previous versions of .NET Core from your system.

    In order to install .NET Core 2.0 Preview 2 on CentOS or Oracle Linux, first you need to get the prerequisites and then you download the .NET Core SDK binaries, extract them onto your system and put dotnet onto your PATH.

    1. sudo yum install libunwind libicu
    2. curl -sSL -o dotnet.tar.gz https://aka.ms/dotnet-sdk-2.0.0-preview2-linux-x64-bin
    3. sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet
    4. sudo ln -s /opt/dotnet/dotnet /usr/local/bin
  2. 2

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  3. 3

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  4. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

Install for Debian 8 (64 bit)

  1. 1

    Install .NET Core 2.0 Preview 2

    Before you start, please remove any previous versions of .NET Core from your system.

    In order to install .NET Core 2.0 Preview 2 on Debian, first you need to get the prerequisites and then you download the .NET Core SDK binaries, extract them onto your system and put dotnet onto your PATH.

    1. sudo apt-get install curl libunwind8 gettext
    2. curl -sSL -o dotnet.tar.gz https://aka.ms/dotnet-sdk-2.0.0-preview2-linux-x64-bin
    3. sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet
    4. sudo ln -s /opt/dotnet/dotnet /usr/local/bin
  2. 2

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  3. 3

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  4. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

Install for Fedora (64 bit)

  1. 1

    Download .NET Core 2.0 Preview 2

    Before you start, please remove any previous versions of .NET Core from your system.

    In order to install .NET Core 2.0 Preview 2 on Fedora, first you need to get the prerequisites and then you download the .NET Core SDK binaries, extract them onto your system and put dotnet onto your PATH.

    Fedora 24, 25, 26

    1. sudo dnf install libunwind libicu
    2. curl -sSL -o dotnet.tar.gz https://aka.ms/dotnet-sdk-2.0.0-preview2-linux-x64-bin
  2. 2

    Install the SDK and put it on the $PATH

    1. sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet
    2. sudo ln -s /opt/dotnet/dotnet /usr/local/bin
  3. 3

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  4. 4

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  5. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

Install for SUSE Linux Enterprise Server (64 bit), openSUSE (64 bit)

  1. 1

    Install .NET Core 2.0 Preview 2

    Before you start, please remove any previous versions of .NET Core from your system.

    In order to install .NET Core 2.0 Preview 2 on openSUSE, first you need to get the prerequisites and then you download the .NET Core SDK binaries, extract them onto your system and put dotnet onto your PATH.

    SLES 12 SP2, openSUSE 42.2

    1. sudo zypper install libunwind libicu
    2. curl -sSL -o dotnet.tar.gz https://aka.ms/dotnet-sdk-2.0.0-preview2-linux-x64-bin
  2. 2

    Install the SDK and put it on the $PATH

    1. sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet
    2. sudo ln -s /opt/dotnet/dotnet /usr/local/bin
  3. 3

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  4. 4

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  5. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

Install for Ubuntu 14.04, 16.04, 16.10 & Linux Mint 17, 18 (64 bit)

  1. 1

    Add the dotnet apt-get feed

    In order to install .NET Core on Ubuntu or Linux Mint, you need to first set up the apt-get feed that hosts the package you need.

    Ubuntu 14.04 / Linux Mint 17

    1. sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ trusty main" > /etc/apt/sources.list.d/dotnetdev.list'
    2. sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 417A0893
    3. sudo apt-get update

    Ubuntu 16.04 / Linux Mint 18

    1. sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
    2. sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 417A0893
    3. sudo apt-get update

    Ubuntu 16.10

    1. sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ yakkety main" > /etc/apt/sources.list.d/dotnetdev.list'
    2. sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 417A0893
    3. sudo apt-get update
  2. 2

    Install .NET Core 2.0 Preview 2

    Before you start, .NET Core 2.0 Preview 1, if previously installed.

    1. sudo apt-get remove dotnet-dev-2.0.0-preview1-005977

    To install .NET Core 2.0 Preview 2 on Ubuntu or Linux Mint, simply use apt-get.

    1. sudo apt-get install dotnet-sdk-2.0.0-preview2-006497
  3. 3

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  4. 4

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  5. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

Install for macOS 10.12 or higher (64 bit)

  1. 1

    Install .NET Core 2.0 Preview 2

    The best way to install .NET Core 2.0 Preview 2 on macOS is to download the official installer.

    Download .NET Core 2.0 Preview 2

    Note: if you have any problems with installation on macOS, please consult our known issues page.

  2. 2

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  3. 3

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  4. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.

  5. Want some tools?

Install for Docker

  1. 1

    Install Docker

    Before you can try out the .NET Core 2.0 preview Docker base images, you should install Docker.

    Refer to the macOS, Windows or Linux getting started instructions for Docker to learn more about installing Docker.

  2. 2

    Run the container using "dotnet" base image

    The following command will get you a running container with the toolchain, straight off of Microsoft's Docker Hub.

    1. docker run -it microsoft/dotnet:2.0-sdk
  3. 3

    Initialize some code

    Let's initialize a sample Hello World application!

    1. dotnet new console -o hwapp
    2. cd hwapp
  4. 4

    Run the app

    One command to update the project, compile the application and run the sample.

    1. dotnet run
  5. And you're ready!

    You now have .NET core running on your machine!

    Visit the .NET Documentation to get access to additional tutorials, samples and the full .NET Core documentation.