dotnet · rbhanda · Feb 13, 2024 · Feb 13, 2024 · Feb 13, 2024 · Feb 13, 2024
diff --git a/README.md b/README.md
@@ -16,13 +16,15 @@ The following [.NET releases](./releases.md) are currently supported:
 
 |  Version  | Release Date | Support | Latest Patch Version | End of Support |
 | :-- | :-- | :-- | :-- | :-- |
+| [.NET 9](release-notes/9.0/README.md) | November 12, 2024 | [STS][policies] | [9.0.0-preview.1][9.0.0-preview.1] |  |
 | [.NET 8](release-notes/8.0/README.md) | [November 14, 2023](https://devblogs.microsoft.com/dotnet/announcing-dotnet-8/) | [LTS][policies] | [8.0.1][8.0.1] | November 10, 2026 |
 | [.NET 7](release-notes/7.0/README.md) | [November 8, 2022](https://devblogs.microsoft.com/dotnet/announcing-dotnet-7/) | [STS][policies] | [7.0.15][7.0.15] | May 14, 2024 |
 | [.NET 6](release-notes/6.0/README.md) | [November 8, 2021](https://devblogs.microsoft.com/dotnet/announcing-net-6/) | [LTS][policies] | [6.0.26][6.0.26]  | November 12, 2024 |
 
 
 You can find release notes for all releases, including out-of-support releases, in the [release-notes](release-notes) directory.
 
+[9.0.0-preview.1]: release-notes/9.0/preview/preview1/9.0.0-preview.1.md
 [8.0.1]: release-notes/8.0/8.0.1/8.0.1.md
 [7.0.15]: release-notes/7.0/7.0.15/7.0.15.md
 [6.0.26]: release-notes/6.0/6.0.26/6.0.26.md

@@ -1,5 +1,17 @@
 # .NET 9
 
-.NET 9 is a [Standard Term Support (STS)](../../release-policies.md) release.
+[.NET 9](https://devblogs.microsoft.com/dotnet/announcing-dotnet-9/) is a [Standard Term Support (STS)](../../release-policies.md) release and will be supported for 18 months, from November 12th, 2024 to May 13th, 2026. It is [supported](../../support.md) on [multiple operating systems](supported-os.md).
+
+- [Downloads](https://dotnet.microsoft.com/download/dotnet/9.0)
+- [Linux Package Managers](https://learn.microsoft.com/dotnet/core/install/linux)
+- [Containers](https://mcr.microsoft.com/catalog?search=dotnet/)
+- [Supported OSes](supported-os.md)
+- [Known Issues](known-issues.md)
+- [Installation instructions](install.md)
+
+## Releases
+
+| Date | Release |
+| :-- | :-- |
+| 2023/02/13 | [9.0.0 Preview 1](preview/preview1/README.md) |
 
-More information coming soon.
@@ -0,0 +1,14 @@
+
+# Get Started
+
+To get started with .NET 9, [install the .NET 9 SDK](https://dotnet.microsoft.com/download/dotnet/9.0).
+
+If you're on Windows using Visual Studio, we recommend installing the latest [Visual Studio 2022 preview](https://visualstudio.com/preview), or get started with Visual Studio Code and the [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) extension.
+
+
+## .NET MAUI
+
+Install the [.NET MAUI workload](install-workloads.md#net-maui)
+
+
+
@@ -0,0 +1,64 @@
+# .NET 9 installation instructions for Linux
+
+The following instructions demonstrate installing .NET 9 on Linux. These instructions augment the more general [.NET install instructions](install.md), including installing with `.tar.gz` files, that work on multiple operating systems.
+
+[Linux package dependencies](linux-packages.md) describes the set of packages required to run .NET on Linux.
+
+## Distributions
+
+The following distributions are available for Linux:
+
+- .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 you install the .NET SDK to develop and build applications, and to install one of the runtime 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/9.0)
+- [.NET 9 release notes](README.md)
+
+[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Linux (Alpine, Debian, and Ubuntu).
+
+## Install using deb/rpm packages
+
+Preview release installers are not available from the Microsoft package repositories. The steps below provide an easy way to install .NET 9 using your Distro package manager.
+
+**Note:** `curl` must be available on the system before running the following steps. Once you have confirmed that `curl` is available, complete the steps to download and install the latest .NET 9 Preview SDK and Runtime.
+
+1. Create a directory to use for the download location and change into that directory. For example, `mkdir $HOME/dotnet_install && cd $HOME/dotnet_install`
+2. Run `curl -L https://aka.ms/install-dotnet-preview -o install-dotnet-preview.sh`
+3. Run the script with `sudo bash install-dotnet-preview.sh`
+
+Here's what the script does.
+
+- Detects the distribution and version. The script supports platforms and versions listed in [.NET 9.0 - Supported OS versions](https://github.com/dotnet/core/blob/main/release-notes/9.0/supported-os.md).
+- Determines if additional system dependencies or utilities are needed to successfully complete and install them. For example, `tar` is used to unpack the installer packages.
+- Downloads the tar.gz containing the .NET preview installer packages for the detected distribution.
+- Downloads the system dependency installer, if needed.
+- Expands the tar.gz into ./dotnet_packages
+- Attempts to install the contents of ./dotnet_packages using `rpm` or `dpkg`, as appropriate, for the detected distribution.
+
+## 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.
+
+```bash
+~# curl -Lo dotnet.tar.gz https://download.visualstudio.microsoft.com/download/pr/f51b05d4-bc43-4290-9b33-aaa212edbba6/e10559d91242409faf5c37cb529de8f3/dotnet-sdk-9.0.100-preview.1.24101.2-linux-x64.tar.gz
+~# mkdir dotnet
+~# tar -C dotnet -xf dotnet.tar.gz
+~# rm dotnet.tar.gz
+~# export DOTNET_ROOT=~/dotnet
+~# export PATH=$PATH:~/dotnet
+~# dotnet --version
+9.0.100-preview.1.24101.2
+```
+
+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.
@@ -0,0 +1,49 @@
+# .NET 9 installation instructions for macOS
+
+The following instructions demonstrate installing .NET 9 on macOS. These instructions augment the more general [.NET install instructions](install.md), including installing with `.tar.gz` files, that work on multiple operating systems.
+
+## Distributions
+
+The following distributions are available for Linux:
+
+- .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 you install the .NET SDK to develop and build applications, and to install one of the runtime 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/9.0)
+- [.NET 9 release notes](README.md)
+
+[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Linux (Alpine, Debian, and Ubuntu).
+
+## Install using PKG
+
+You can install any of the distributions with PKG. The following image demonstrates installing the .NET SDK. After launching the PKG, click "Continue" and you will be taken through the process of installing the SDK.
+
+![image](https://user-images.githubusercontent.com/2608468/112776700-355d5280-8ff5-11eb-979c-8cab273f5f97.png)
+
+## 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.
+
+```bash
+~# curl -Lo dotnet.tar.gz https://download.visualstudio.microsoft.com/download/pr/9956af63-be37-43be-a854-01f3a95e12fe/60d97a3f4f53b33376b8df055a14cf39/dotnet-sdk-9.0.100-preview.1.24101.2-osx-x64.tar.gz
+~# mkdir dotnet
+~# tar -C dotnet -xf dotnet.tar.gz
+~# rm dotnet.tar.gz
+~# export DOTNET_ROOT=~/dotnet
+~# export PATH=$PATH:~/dotnet
+~# dotnet --version
+9.0.100-preview.1.24101.2
+```
+
+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.
@@ -0,0 +1,64 @@
+# .NET 9 installation instructions for Windows
+
+The following instructions demonstrate installing .NET 9 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 runtime 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/9.0)
+- [.NET 9 release notes](README.md)
+
+[Container images](https://hub.docker.com/_/microsoft-dotnet) are provided for Windows (Nano Server and Server Core) and Linux (Alpine, Debian, and Ubuntu).
+
+## Windows Package Manager CLI (winget)
+
+You can now install .NET updates using the Windows Package Manager CLI (winget):
+
+- To install the .NET 9 runtime: `winget install dotnet-runtime-9`
+- To install the .NET 9 SDK: `winget install dotnet-sdk-9`
+- To update an existing installation: `winget upgrade`
+
+See [Install with Windows Package Manager (winget)](https://learn.microsoft.com/dotnet/core/install/windows?tabs=net70#install-with-windows-package-manager-winget) for more information.
+
+## 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.
+
+![dotnet installer](https://github.com/dotnet/core/assets/44339330/62cbf002-89ab-4d63-9f0a-69460a6ab3d0)
+
+## 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 -Lo dotnet.zip https://download.visualstudio.microsoft.com/download/pr/bb120bd7-6656-4ebf-9efc-87dbbbd2f344/ef7cb2cf73d9a740c2af0b4ca9c2266e/dotnet-sdk-9.0.100-preview.1.24101.2-win-x64.exe
+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
+9.0.100-preview.1.24101.2
+```
+
+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.
@@ -0,0 +1,25 @@
+# .NET Workloads
+
+After installing .NET 9 previews, you can install workloads by following these instructions. For more information read through the [documentation](https://learn.microsoft.com/dotnet/core/tools/dotnet-workload).
+
+## .NET MAUI
+
+Install the .NET MAUI workload:
+
+```
+> dotnet workload install maui
+...
+Successfully installed workload(s) maui.
+```
+
+Verify installation:
+
+```
+> dotnet workload list
+
+Installed Workload Id      Manifest Version                            Installation Source
+--------------------------------------------------------------------------------------------
+maui                    9.0.0-preview.1.9973/9.0.100-preview.1     SDK 9.0.100-preview.1
+```
+
+Installing the `maui` workload includes `android`, `ios`, and `maccatalyst` workloads which may be installed independently. Run `dotnet workload search` for a full list of available workload configurations.
@@ -0,0 +1,95 @@
+# .NET 9 installation instructions
+
+Concise install instructions are provided in this document and may be augmented in [release notes](README.md) for a given update. Complete [.NET installation instructions for Windows, macOS, and Linux](https://learn.microsoft.com/dotnet/core/install/) are provided for supported releases in [.NET documentation](https://learn.microsoft.com/dotnet).
+
+Operating system specific instructions:
+
+- [Linux](install-linux.md)
+- [macOS](install-macos.md)
+- [Windows](install-windows.md)
+
+## [Using dotnet-install-scripts](https://learn.microsoft.com/dotnet/core/tools/dotnet-install-script)
+
+### Install the latest preview version of the 9.0.1xx SDK to the specified location
+
+Windows:
+
+```console
+./dotnet-install.ps1 -Channel 9.0.1xx -Quality preview -InstallDir C:\cli
+```
+
+macOS/Linux:
+
+```console
+./dotnet-install.sh --channel 9.0.1xx --quality preview --install-dir ~/cli
+```
+
+### Install the latest preview version of the 9.0.0 runtime to the specified location
+
+Windows:
+
+```console
+.\.dotnet\dotnet-install.ps1 -Channel 9.0 -Runtime dotnet -Quality preview -InstallDir c:\cli
+```
+
+macOs/Linux:
+
+```console
+./dotnet-install.sh --runtime dotnet --channel 9.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 runtime packages (like ASP.NET Core) to (exclusively) run applications.
+
+## Downloads
+
+Download links are provided for each of the distributions at:
+
+- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/9.0)
+- [.NET 9 release notes](preview/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).
+
+## What's installed?
+
+You can determine what is installed on your machine (assuming .NET is installed) using the following approach, with `dotnet --info`.
+
+```console
+C:\>dotnet --info
+.NET SDK (reflecting any global.json):
+Version:   9.0.100-preview.1.24101.2
+ 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/9.0.100-preview.1.24101.2/
+
+Host:
+  Version:      9.0.0-preview.1.24080.9
+  Architecture: x64
+  Commit:       550605cc93
+
+.NET SDKs installed:
+9.0.100-preview.1.24101.2 [/usr/local/share/dotnet/x64/sdk]
+
+.NET runtimes installed:
+  Microsoft.AspNetCore.App 9.0.0-preview.1.24081.5 [/usr/local/share/dotnet/x64/shared/Microsoft.AspNetCore.App]
+  Microsoft.NETCore.App 9.0.0-preview.1.24080.9 [/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:
+
+```console
+C:\>dotnet --version
+9.0.100-preview.1.24101.2
+```