dotnet-core/release-notes/6.0/install-windows.md
Rich Lander d05daa63ee
Update release notes format (#6100)
* Update release notes

* Update release notes

* Update .NET 6 releae notes

* Update table

* Update links

* Update release table

* Update 2.1

* Update table

* Update links

* Add linux packages doc

* Add link to packages doc

* Update Arch instructions

* Add statement about globalization invariant mode

* Apply suggestions from code review

Co-authored-by: Michael Simons <msimons@microsoft.com>
Co-authored-by: Matt Thalman <mthalman@microsoft.com>

* Update per feedback

* Update link

* Add buster

* Update heading

* Cleanup wording

* Update per feedback

* Update per feedback

* Apply suggestions from code review

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>

* Update perf feedback

* Update release-policies.md

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>

Co-authored-by: Michael Simons <msimons@microsoft.com>
Co-authored-by: Matt Thalman <mthalman@microsoft.com>
Co-authored-by: Maira Wenzel <mairaw@microsoft.com>
2021-03-31 15:18:03 -07:00

55 lines
3.2 KiB
Markdown

# .NET 6 installation instructions for Windows
The following instructions demonstrate installing .NET 6 on Windows. These instructions augment the more general [.NET install instructions](install.md), including installing with `.zip` files, that work on multiple operating systems.
## Distributions
The following distributions are available for Windows:
- .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.
- .NET Desktop Runtime: includes the .NET runtime and Windows desktop libraries, enabling running console, Windows Forms, and Windows Presentation Framework (WPF) applications.
- ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications.
- ASP.NET Core Hosting Bundle: includes the ASP.NET Core runtime and IIS support (for running both in- and out-of-process with IIS).
We recommend 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
Each of the distributions can be downloaded from:
- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/6.0)
- [.NET 6 release notes](README.md)
[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Windows (Nano Server and Server Core) and Linux (Alpine, Debian, and Ubuntu).
## Install using MSI
You can install any of the distributions with MSI. The following image demonstrates installing the .NET SDK. After launching the MSI, click "Install" and you will be taken through the process of installing the SDK.
![image](https://user-images.githubusercontent.com/2608468/112773547-4a34e880-8feb-11eb-8671-59fffceffd42.png)
## Windows Server Hosting with IIS
You should install the Hosting Bundle MSI if you want to enable hosting ASP.NET Core with IIS.
## Installing from a binary archive
You can install .NET with a binary archive. This option is required if you want to install .NET for a single user. It is also recommended if you want to install .NET temporarily.
The following workflow demonstrates downloading, unpacking, configuring, and running the .NET SDK from the command line. You may choose to do some of these tasks via the browser and functionality provided by your operating system.
```console
C:\>curl -o dotnet.zip https://download.visualstudio.microsoft.com/download/pr/5b31ca8e-f684-4de7-9889-c53ce6cf9a3c/e85b1ef8dc6004c5f5bd0019771b21c5/dotnet-sdk-6.0.100-preview.2.21155.3-win-x64.zip
C:\>tar -C dotnet -xf dotnet.zip
C:\>del dotnet.zip
C:\>set DOTNET_ROOT=C:\dotnet
C:\>set PATH=%PATH%;C:\dotnet
C:\>dotnet --version
6.0.100-preview.2.21155.3
```
The `DOTNET_ROOT` environment variable is required to launch an application with their executables (like `myapp.exe`). The executables look for this environment variable to find the runtime if it isn't installed in its regular location. The `PATH` environment variable must be updated if you want to use `dotnet` without absolute paths to its location. Setting both of these environment variables is optional.
You can add your .NET install location permanently to your path if you'd like.