core

.NET 8 installation instructions

Concise install instructions are provided in this document and may be augmented in release notes for a given update. Complete .NET installation instructions for Windows, macOS, and Linux are provided for supported releases in .NET documentation.

Operating system specific instructions:

Using dotnet-install-scripts

Install the latest preview version of the 8.0.1xx SDK to the specified location

Windows:

./dotnet-install.ps1 -Channel 8.0.1xx -Quality preview -InstallDir C:\cli

macOS/Linux:

./dotnet-install.sh --channel 8.0.1xx --quality preview --install-dir ~/cli

Install the latest preview version of the 8.0.0 runtime to the specified location

Windows:

.\.dotnet\dotnet-install.ps1 -Channel 8.0 -Runtime dotnet -Quality preview -InstallDir c:\cli

macOs/Linux:

./dotnet-install.sh --runtime dotnet --channel 8.0 --quality preview --install-dir ~/cli

Distributions

The following distributions are available for all operating systems:

.NET SDK: includes tools for building and testing applications, and includes the runtime distributions that follow.
.NET Runtime: includes the .NET runtime and libraries, enabling running console applications.
ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications.

We recommend that you install the .NET SDK to develop and build applications, and to install one of the runtimes packages (like ASP.NET Core) to (exclusively) run applications.

Downloads

Download links are provided for each of the distributions at:

Container images are provided for Windows (Nano Server, and Server Core) and Linux (Alpine, Debian, and Ubuntu).

What’s installed?

You can determine what is installed on your machine (assuming .NET is installed) using the following approach, with dotnet --info.

C:\>dotnet --info
.NET SDK (reflecting any global.json):
Version:   8.0.100-preview.3.23178.7
 Commit:    0a5360315a

Runtime Environment:
 OS Name:     Mac OS X
 OS Version:  12.6
 OS Platform: Darwin
 RID:         osx.12-x64
 Base Path:   /usr/local/share/dotnet/x64/sdk/8.0.100-preview.3.23178.7/

Host:
  Version:      8.0.100-preview.4.23260.5
  Architecture: x64
  Commit:       550605cc93

.NET SDKs installed:
  8.0.100-preview.4.23260.5 [/usr/local/share/dotnet/x64/sdk]

.NET runtimes installed:
  Microsoft.AspNetCore.App  8.0.0-preview.4.23260.4 [/usr/local/share/dotnet/x64/shared/Microsoft.AspNetCore.App]
  Microsoft.NETCore.App 8.0.0-preview.4.23259.5 [/usr/local/share/dotnet/x64/shared/Microsoft.NETCore.App]

If you have the .NET SDK installed, you can also use dotnet --version as demonstrated in the following example:

C:\>dotnet --version
8.0.100-preview.4.23260.5

This site is open source. Improve this page.